Io li odio.
Trovo che boolean && true || false sia molto compensibile.
Al di là del fatto che “boolean ? true : false” in ruby può diventare
solo
“boolean”
[…] ma comunque scrivere codice commentato e` ritenuta una buona
pratica da sempre.
Un’ottima ragione per mettere commenti nel codice è spiegare
(spiegarsi!) non tanto cosa fa, ma il perché si siano prese certe
decisioni nello scriverlo. C’è chi dice che non capire cosa faccia il
codice a distanza di mesi è segno che non lo si era scritto bene, e in
linea di principio posso essere d’accordo, ma alle volte capita che si
usi qualche algoritmo anche bizzarro, o che si facciano certi test, o
che si usino certi after/before filter, etc… per delle ragioni ben
precise e allora è meglio documentarle.
Paolo
PS: mi piacciono i ternary ma cerco di tenerli molto brevi, altrimenti
non si capisce più nulla
Quel libro l’ho letto/studiato tutto ed e fantastico e sicuramente quel libro va contro i consigli tipo 'avoid ternary operators' perche i
rubysti cercano d’eseere coincisi. Per quanto riguarda i commenti, visto
che Ruby e molto espressivo, possiamo evitare di scrivere commenti inutili, ma comunque scrivere codice commentato e ritenuta una buona
pratica da sempre.
che si usino certi after/before filter, etc… per delle ragioni ben
precise e allora meglio documentarle.
Mah, se usi github hai una wiki a disposizione
Io odio i commenti nel codice, spiace ma e’ cosi’.
Vedo dei commenti e ho proprio il ditino che va verso i dd di vim.
Ma i commenti sono la` attaccati al codice: vengono sempre conservati,
github o meno, e sono proprio dove uno si aspetta di trovarli.
Io odio i commenti nel codice, spiace ma e’ cosi’.
Vedo dei commenti e ho proprio il ditino che va verso i dd di vim.
Mi sembra un po’ drastico.
Linus Torvalds:
Comments are good, but there is also a danger of over-commenting.
NEVER try to explain HOW your code works in a comment: it’s much
better to write the code so that the working is obvious, and it’s a
waste of time to explain badly written code.
Generally, you want your comments to tell WHAT your code does, not
HOW. Also, try to avoid putting comments inside a function body: if
the function is so complex that you need to separately comment parts
of it, you should probably go back to chapter 4 for a while. You can
make small comments to note or warn about something particularly
clever (or ugly), but try to avoid excess. Instead, put the comments
at the head of the function, telling people what it does, and possibly
WHY it does it.
Ma i commenti sono la` attaccati al codice: vengono sempre conservati,
github o meno, e sono proprio dove uno si aspetta di trovarli.
Beh, proprio per quello se il commento e’ strettamente legato al
codice che si e’ scritto (e quindi il codice e’ poco chiaro), o
altrimenti si
va in ambiti ben pi’ ampi del singolo metodo/oggetto e a livello di
design.
Sara’ drastico, ma che cosa vuoi commentare a quel livello? Il design
del
ciclo o del condizionale?
Ormai quello che una volta si faceva in 300 righe di codice una volta
ora lo
si fa in una manciata, abbasso i commenti evviva le wiki.
Minghia, quasi quasi mi faccio flammare su HN a riguardo appena ho quei
venti minuti
waste of time to explain badly written code.
Generally, you want your comments to tell WHAT your code does, not
HOW. Also, try to avoid putting comments inside a function body: if
the function is so complex that you need to separately comment parts
of it, you should probably go back to chapter 4 for a while. You can
make small comments to note or warn about something particularly
clever (or ugly), but try to avoid excess. Instead, put the comments
at the head of the function, telling people what it does, and possibly
WHY it does it.
Eh, lui li preferisce all’inizio del file, io altrove
Seriamente, e’ necessario discutere del design di un software
all’interno
del software stesso, o discutere di una scelta presa all’interno del
file in cui la
si e’ presa? Boh, de gustibus, io li uso poco.
Se vai a leggerti i motivi per cui commentare e per cui usare i commenti
per esempio
qui: http://www.amazon.com/Practice-Programming-Addison-Wesley-Professional-Computing/dp/020161586X
ti accorgi che tutte le argomentazioni portate sono rovinosamente
anacronistiche.
Saro’ drastico ma la penso cosi’.