No tienes acceso a esta clase

隆Contin煤a aprendiendo! 脷nete y comienza a potenciar tu carrera

Cu谩ndo usar comentarios

20/24
Recursos

Aportes 10

Preguntas 1

Ordenar por:

驴Quieres ver m谩s aportes, preguntas y respuestas de la comunidad?

  • El comentario no debe explicar:

    • 鉂 El 驴Qu茅? 鈬 porque el c贸digo debe ser Autodescriptivo
    • 鉂 El 驴C贸mo? 鈬 el c贸digo debe ser Autoexplicativo
    • 鉁 Sino el 驴Por qu茅? // Comentar explicando los Criterios, aportando valor

鈥淣o comentes c贸digo mal escrito, reescr铆belo.鈥
Brian Kernighan

  • Si bien, al usar correctamente la nomenclatura, el ordenamiento de nuestras variables, funciones y clases y respetar el principio de responsabilidad 煤nica, va a hacer que nuestro c贸digo sea mucho m谩s f谩cil de entender, no significa que se deba dejar de a帽adir comentarios. Por ejemplo, a帽adir un comentario sobre alguna librer铆a externa que se haya utilizado.

Yo solo vengo a dejar este 茅pico Link

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

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.

Ojo con dejar todo鈥檚 por ahi, ja

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.

"Yo comento lo que se me da la gana."
Yo.