‫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, sin tratar 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 para comentar,
‫puede leer algunos de lo que se debe y no se 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.