Hablemos de otro desarrollador, fundamental, y este está comentando tu código.
Hasta ahora, es posible que me hayan visto comentar en los comentarios de nuestros guiones.
Por ejemplo, aquí mismo, agregué un comentario de booleanos, y esto le dice al intérprete de Python, oye, esto es un
comentario, no ejecutes esto, es solo para mí.
Puede simplemente ignorarlo y pasar a la línea dos.
Y lo viste.
Simplemente hice eso en Python con el signo.
Tan pronto como Python ve un signo de libra, agrega un comentario.
Y también puedes hacerlo después de una línea.
Puedo decir que esto se asigna a una variable.
Y aunque esto puede parecer dos líneas, en realidad es solo el ajuste de palabras lo que está sucediendo y
puede ver que el intérprete simplemente ignora por completo estos comentarios.
Ahora, comentar suena muy, muy simple, pero es un concepto importante.
Y si quieres ser un buen programador en todos los idiomas, lo tenemos comentando.
Pero hay buenos días y malas formas de comentar.
Y esto es algo que viene con la práctica, pero aquí hay algunas pautas clave.
Cuando estás comentando tu código, la idea es que estás agregando comentarios valiosos, es decir,
si agrego un comentario aquí que diga, oye, esta es una variable de nombre de signo, un valor de la fuerza de Andre, un comentario como este
.
No es realmente bueno.
¿Porqué es eso?
Bueno, porque tu código debería ser autoexplicativo, ¿verdad?
La idea es que escribamos código que sea fácil de leer, fácil de entender.
No está tratando de ser inteligente.
En cambio, debería leerse como en inglés.
Y cualquier programador de Python lo sabría aquí.
Simplemente estamos agregando a Andre como un valor de nombre.
Estamos asignando una variable y agregando un comentario como este que se explica por sí mismo y solo agrega desorden a
su código.
Así que hay una compensación aquí, es bueno comentar su abrigo, digamos, si está trabajando
en equipos y otros desarrolladores vienen y quieren entender su código, pero debe recordar este principio de
que el código es fácil de leer. .
La única vez que desea agregar comentarios a su código es, bueno, cuando algo realmente importante está sucediendo,
donde podría ser un poco complejo, primero decide, oye, ¿este código está escrito de una manera
que tenga sentido?
Por ejemplo, si esta fuera la variable A.
Y esta fue la variable B.
Bueno, esto puede ser realmente difícil de entender para alguien, por lo que podría decir que esta es una bandera
genial.
Pero antes de agregar ese comentario, querrá decirse a sí mismo, tal vez mi código sea difícil de leer,
tal vez debería cambiar la variable a es genial para hacerlo más comprensible.
Ahora, esto es algo en lo que mejora cada vez más y desea utilizar los comentarios como una herramienta adicional para hacer que su
código sea comprensible, tal vez escriba un código que dentro de seis meses desea volver para
comprender lo que hizo.
Pero recuerde, más comentarios no significa necesariamente un mejor código.
Quiere ser conciso y mantener las cosas simples mientras agrega comentarios solo cuando sea necesario para ayudar a otros a comprender su
código, no tratando de hacer que su código ilegible sea más legible.
Exploraremos este tema y le daremos consejos a lo largo del curso.
Pero recuerde este desarrollador clave fundamental porque lo necesitará a lo largo de su carrera.
Por cierto, este artículo tiene algunos puntos realmente importantes de los que creo que se beneficiará mucho, especialmente en las mejores prácticas de
comentarios, puede leer algunas de las cosas que debe y no debe hacer y lo que hacen algunos de
los mejores programadores cuando comentando.
Sé que suena tonto, pero es un concepto importante que la mayoría de los cursos pasan por alto.
Así que te recomiendo que leas esto.
Lo vincularé en los recursos y nos vemos en el siguiente video.