Sembra che alcune regole di scrittura del codice siano in diretta contraddizione con le regole della scrittura umana. Ad esempio nel codice è consigliabile definire ogni informazione in un solo posto e per iscritto per gli umani è normale ripetere punti importanti (anche se di solito sono formulati in modo diverso).
Quali regole di scrittura del buon codice contraddicono le regole della buona scrittura?
Indentation rules (most coding standards impose) really contradict
rules of good writing,
the way people perceive information,
and the grammar rules.
Making things (that group naturally, but not syntactically) inside
parenthesis also contradicts how texts are usually typed.
If (you try to type text that way)
you'll face misunderstanding even (if programmers read you)
otherwise
your text will be easy to read,
and your writing will be productive
!
Il buon codice non richiede interpretazione laddove una buona scrittura spesso può. Mi viene in mente Shakespeare come esempio qui. L'imprecisione di alcuni scritti non esiste nel codice spesso è un altro modo per vederlo.
La buona poesia scritta consente al lettore di apprezzare la musica di suoni che risuonano insieme.
Buona poesia in codice (non sarei sorpreso se qualcuno venisse con un esempio di IOCCC) lascia che il lettore ne apprezzasse solo le prestazioni (e il compilatore non si accorgerebbe affatto).
Leggi altre domande sui tag coding-standards writing