En cuanto a la forma "estándar" para poner los comentarios dentro del código fuente de Python:comentarios Python: # vs. cadenas
def func():
"Func doc"
... <code>
'TODO: fix this'
#badFunc()
... <more code>
def func():
"Func doc"
... <code>
#TODO: fix this
#badFunc()
... <more code>
prefiero escribir comentarios generales como cadenas en lugar de un prefijo # 's. La guía de estilo oficial de Python no menciona el uso de cadenas como comentarios (si no me lo perdí al leerlo).
Me gusta así, principalmente porque creo que el carácter #
se ve feo con los bloques de comentarios. Hasta donde yo sé estas cadenas no hacen nada.
¿Hay desventajas al hacer esto?
Para el registro, no parece que afectará el rendimiento. Al mirar la salida dis.dis, o al ejecutar cadenas en un módulo compilado, no se observan rastros de las cadenas, por lo que parece que se han optimizado durante la compilación. (Las otras razones son más que suficientes, sin embargo) – Brian