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
Contenido del curso
Cuándo usar comentarios
Elcira Ibarra
Estudiante
Billy Torres
Estudiante
Jaime Eduardo Falla Cardozo
EstudianteBilly Torres
Estudiante
Daniel Ochoa
Estudiante
Humberto Guardado
Estudiante
Reinaldo Mendoza
EstudianteJaime Eduardo Falla Cardozo
Estudiante
José Antonio Medina Sánchez
Estudiante
Jose Ever Muñoz Muñoz
Estudiante
Markin Piero Pulache Guarniz
Estudiante
Nayru Alexandra Ramirez Molano
Estudiante
Edward Larsson Vega Carrillo
EstudianteReinaldo Mendoza
EstudianteMarkin Piero Pulache Guarniz
Estudiante
Axel Enrique Galeed Gutierrez
Estudiante
Jesus Adrian Camarena Cortez
Estudiante
Joan Alexander Valerio Rodríguez
Estudiante
Maria Alejandra Luna Tito
Estudiante
Juan Diossa
EstudianteEl 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"