Barrapunto

Documentar el código es una buena práctica, pero claaaaro, ¿para que vas a documentar algo que has hecho tú? ¿para que otro lo entienda cuando tú no estés?

Y lo mejor son los comentarios del tipo "instanciamos los objetos" o "ejecuto una query" xD

Estas prácticas hay que exigirlas desde arriba, pero como los de arriba no tienen que pelearse con el código...

... tambien hay que decir que mi c es algo ofuscado, pero por lo contrario es muy eficaz a la hora de usas recursos de la maquina ...

Pues la verdad es que no tiene nada que ver, porque al compilador para generar el código lo que le importa es el contenido y no la forma en la que se encuentra estructurado.

Por tanto, se puede hacer un código "visible" y óptimo sin el más mínimo problema.

Personalmente, creo que si necesitas más lineas de comentario que de código, hay algo que falla con esa función. Creo que tu mismo lo has dicho cuando comentas que tu c es algo ofuscado :-)

Leí una vez en un manual de programación que poner comentarios en exceso es fallo de diseño. Si ofuscas mucho tu código, dentro de unos meses, cuando tengas que hacer mantenimiento, vas a perder mucho tiempo intentando "casar" lo que dices en tu comentario con código como se te haya olvidado y si, encima, hay gente que no se entera, para ti también será difícil de entender. Como dicen por ahí, mejor dividir el código en partes más simples y tener un estándar para documentar las cosas como por ejemplo esta [itcdguzman.edu.mx].