I commenti nel codice e' senza dubbio uno dei miei argomenti preferiti: io sono per la zero policy. Nessun commento, a parte cio' che non puo' in alcun modo essere espresso in codice.
Oggi guardavo un po' di codice e mi imbatto in:
#ifndef
_XXXX_MANAGER_HPP_
#define _XXXX_MANAGER_HPP_ /// Include guard. A parte l'underscore di fronte ad un identificatore che in C++ e' riservato al compilatore e al comitato di standardizzazione, quindi non deve mai essere usato: il commento e' quanto meno illuminante.
Il prossimo entra dritto nella top 10:
# define
IGNORE_MISSING_DX_FILE // ignore missing file Il commento dice meno di cio' che cerca di commentare.
Come nota a margine, nel progetto c'e' un Null Object Pattern implementato da manuale, mai usato. Sembra li' per dire "Guardate, ho letto Design Patterns". Ma non hai letto "Refactoring to Patterns".
Cui prodest?
Sto seriamente valutando l'ipotesi di creare una AntiComment Police con licenza di uccidere.