Guía completa para documentar código Python
La documentación es crucial porque 'el código se lee más de lo que se escribe' (Guido van Rossum) y sin buena documentación la gente no usará el software (Daniele Procida). Comentarios: para desarrolladores, explican el 'porqué' del código. Deben ser breves (máx. 72 caracteres) y seguir reglas como estar cerca del código que describen.