Estilo de codigo.

[xultz]

Aqui no meu trabalho tem mais pessoas que entendem de programação do que de hardware (esses eng de computação são uma praga que precisa ser combatida, porque estão se reproduzindo rápido demais).
Eu já vi casos que o sujeito que só fez software e firmware tem que desenhar um circuito, enche o esquemático de comentários... já vi até casos que o cara colocou "resitor para limitar e corrente que passa no led".

[polesapart]

o meu hardware tem selo de aprovacao chuck norris!

Dizem que o chuck norris nunca teste um hardware, ele apenas olha sem tocar na placa e detecta inconsistências usando um olho biônico. Pq se ele efetivamente testar, a placa vira migalhas e solta fumaça de medo!

[andre_luis]

...eu mesmo evito sempre que possivel, e NUNCA comento o que uma linha de codigo faz, no maximo, coloco um cabeçalho na rotina...

Sou partidário dessa opinião também, mas até certo ponto.
Comentário em exagero polui o código e atrapalha a inteligibildade, surtindo um efeito contrário do proposto.

Outra coisa é que a exemplo do assembly, os comentários á direita do código, e não no começo da linha, dá a opção do programador de ignora-los.

+++