COMO ESCRIBIR COMENTARIOS EN PYTHON

 

Comentarios

Los comentarios son anotaciones que podemos incluir en nuestro programa y que nos permiten aclarar ciertos aspectos del código. Estas indicaciones son ignoradas por el intérprete de Python.

Los comentarios se incluyen usando el símbolo almohadilla # y comprenden hasta el final de la línea.

Comentario en bloque
# Universe age expressed in days
universe_age = 13800 * (10 ** 6) * 365

Los comentarios también pueden aparecer en la misma línea de código, aunque la guía de estilo de Python no aconseja usarlos en demasía:

Comentario en línea
stock = 0   # Release additional articles

Reglas para escribir buenos comentarios: [6]

  1. Los comentarios no deberían duplicar el código.

  2. Los buenos comentarios no arreglan un código poco claro.

  3. Si no puedes escribir un comentario claro, puede haber un problema en el código.

  4. Los comentarios deberían evitar la confusión, no crearla.

  5. Usa comentarios para explicar código no idiomático.

  6. Proporciona enlaces a la fuente original del código copiado.

  7. Incluye enlaces a referencias externas que sean de ayuda.

  8. Añade comentarios cuando arregles errores.

  9. Usa comentarios para destacar implementaciones incompletas.

Comentarios

Entradas más populares de este blog

PySDR: una guía para SDR y DSP usando Python by Dr. Marc Lichtman. Introducciòn.

Colecciones de datos/set