Cuándo usar comentarios
Contenido del curso
Nombre y uso de las variables
Ámbito de las variables
Funciones
Clases
Optimizaciones
Cierre
Cuándo usar comentarios
Cuándo usar comentarios
Contenido del curso
Elcira Ibarra
Billy Torres
Jaime Eduardo Falla Cardozo
Billy Torres
Daniel Ochoa
Humberto Guardado
Reinaldo Mendoza
Jaime Eduardo Falla Cardozo
José Antonio Medina Sánchez
Jose Ever Muñoz Muñoz
Markin Piero Pulache Guarniz
Nayru Alexandra Ramirez Molano
Edward Larsson Vega Carrillo
Reinaldo Mendoza
Markin Piero Pulache Guarniz
Axel Enrique Galeed Gutierrez
Jesús Adrián Camarena Cortez
Joan Alexander Valerio Rodríguez
Maria Alejandra Luna Tito
Juan Diossa
El comentario no debe explicar:
“No comentes código mal escrito, reescríbelo.” Brian Kernighan
🙌👌🏼
Pienso que, a veces si son necesarios los comentarios para intentar explicar lógica de negocio que puede llegar a ser confusa y los comentarios pueden dar una idea de lo que hace. Por ejemplo, poner ejemplos en el comentario
cierto bro
También sirve para acordamos que hicimos, pasan los meses y volvemos al código y ya no tenemos idea de lo que hicimos. en mi caso al principio de la clase siempre documento, colocando fecha. 22/04/2023 Agregue este método para actualizar la existencia en X tabla por ejemplo
"Yo comento lo que se me da la gana." Yo.
Ojo con dejar todo's por ahi, ja
Completamente de acuerdo
Yo pienso que si mi código ya cumple con los principios solid o clean code, será poco necesario por que ya será autoexplicativo, al menos que requiera dar avisó del porque se utilizo alguna librería en particular como lo mencionan o porque se decidido hacerlo de una forma y no de otra. Saludos!!
Pienso que los comentarios son muy importantes al inicio cuando vas aprendiendo, a veces llegas a una solucion y cuando la lees una semana despues no logras entender como funciona del todo, la solucion es un comentario que te refresque la memoria.
Con el tiempo y la experiencia cada vez son menos necesarios, no obstante sigo pensando que pueden servirles a los nuevos empleados principiantes de la empresa.
Ademas existen los compiladores como Webpack que ya se encargan de quitar estos comentarios para produccion.
buen aporte
Jummm la cosa es saber hasta qué punto añadir comentarios
Como hago para los TODO?
resolverlos casi de una
tampoco la tengo claro
Creo que en estos casos es muy recomendable el uso de JSDoc o TSDoc, ya que va a ayudar a la experiencia de desarrollo y a tener una mejor lectura del código.
Creo que el código se debe de explicar en cosas muy importantes, o muy pesadas de entender.
Dentro de la práctica, lo recomendable escribir comentarios para explicar usos o soluciones que le has dado a un código en especifico. Esto puede servir para entendimiento de un grupo de trabajo.
esta bien dejar TODOs o TECHDEBT?
Pienso que si es importante, ya que aunque el código sea auto-descriptivo y auto-explicativo, no está de más dejar alguna nota que describa comportamientos y/o funcionalidades que permitan entender un bloque de código en un renglón de texto, ya que como se dice por ahí "pasas más tiempo leyendo código que escribiéndolo"