Cuando se trata de la documentación del código, generalmente se acepta que el código debeexplícate, y la documentación del código en línea (excluyendo la documentación pública de la API) solo debe explicar los problemas del metacódigo, como soluciones alternativas, explicaciones de por qué se eligieron implementaciones específicas, etc.

¿Cómo logras que tu código sea más legible y másexplicando a sí mismo?

Editar además de los comentarios generales, también estoy buscando consejos específicos. Por lo tanto, si dice "nombres de variables cortos pero significativos", sería bueno recibir también una sugerencia útil (por ejemplo, "use el principio de tres palabras").