No escribir comentarios y dejar que el código se explique por sí solo está completamente fuera de la realidad.
Los lenguajes de programación existen para el bien de los humanos, existen para poder comunicarnos con computadoras.
Los buenos programadores escriben código que otros humanos puedan entender.
Cualquier cosa que ayuda a mejorar esto, incluyendo comentarios, es bienvenida.
Es que resulta que ayer o antes de ayer empezó un debate en Twitter donde empiezan todos los debates del mundo,
donde se ponen ahí a palearse y tal.
Y yo creo que muchas veces incluso son debates que es para generar interacción.
Que en realidad la persona que los escribe ni los cree y sabe que en realidad es para llamar la atención, la interacción.
A lo mejor a veces se inventan incluso qué es lo que piensan o que alguien les ha dicho y tal.
Es todo mentira y en realidad no digo que sea el caso.
Simplemente digo que pasa porque no paro de ver todos los días como discusiones que se nota que están cocinadas.
Que dices, ostras, pero esto es mentira, esto es mentira.
No me decepcionen, Midu. 2 más 2 siempre será 4.
A otro tema, ¿no?
Porque me parece bastante interesante.
Más allá del debate, sí que he visto que hay gente que metía bastante temas sobre esto de los comentarios están mal, están bien.
Hay un montón de gente que tiene como opiniones muy fuertes de estas cosas que me parecen tan tontería.
Como que en la vida real, allí fuera, en las empresas, son cosas que a nadie le quita mucho el sueño, ¿no?
Y me sorprende que la gente muchas veces le dedique una energía tan fuerte o que tenga unos sentimientos tan fuertes de incluso insultar a otros, ¿no?
O de llegar a categorizar y juzgar a los demás.
Como, si no pones comentarios, eres tal.
Si pones comentarios, es que eres mal programador.
Es que si no sé qué, no sé cuánto.
Todo el rato así, ¿no?
Y cuando en la vida real siempre es todo una escala de grises.
Es obvio, obvio.
Hay que intentar que el código sea lo más autoexplicativo posible, que se entienda por sí mismo.
Y que los comentarios no dejan de ser una herramienta más, pues para poner más contexto.
Si por lo que sea el código no se puede entender.
Lo que no vamos a hacer es poner.
Aquí estoy creando una variable con el nombre A.
Esta es la función sumar que suma dos parámetros.
Obviamente, esos no son los buenos comentarios.
Igual que muchas veces no hay buen código.
Pero sí que es súper importante que existan comentarios que pueden ser incluso enlaces a referencias de documentación.
Explicaciones de por qué se hace así cuando pueda extrañarle a otra persona.
O sea, los comentarios dejan de ser una herramienta que muchas veces se tiene que utilizar y se debe utilizar para proveer del mejor contexto posible a la gente.
Y ya está.
Tampoco me parece una cosa tan polémica, que la gente lo ve como algo muy polémico.
Y yo creo que las cosas se ven polémicas cuando las ve blanco o negro.
Comentarios sí o comentarios no, ¿sabes?
Y la gente se pone ahí como, no, sí, no, no.
Y es del palo.
Es que depende.
Yo lo que creo es que los comentarios se deberían usar para decir por qué se ha hecho así en lugar de explicar qué hace el código.
Sí, pero es que incluso yo he visto a veces el por qué explicar qué hace el código.
Porque el código a lo mejor era muy complicado y a lo mejor o no había herramientas para hacerlo mejor.
O es un cálculo muy complejo que requiere pues explicarlo paso a paso.
Yo he visto un poco de todo y a veces puedo incluso entender porque hay código que a lo mejor no lo has tocado tú y añades comentarios para la siguiente persona que venga.
Porque ya que tú entendiste el código, pues lo explicas para que la siguiente persona no tenga que volver a entenderlo.
El comentario muchas veces, la gente cree que los comentarios además los pones justo cuando crean la línea.
Y eso tampoco tiene por qué ser así, ¿no?
Uncle Bob tiene su filosofía de esto bastante clara.
Bueno, pero es que Uncle Bob tiene muchas cosas muy claras que tampoco han envejecido muy bien, ¿eh?
Como él, la verdad.
Los comentarios nunca están de más.
Mejor pecar de exceso que quedarse corto y tener que descifrar ternarias.
Puede pecar de exceso, ¿eh?
Puede pecar de exceso porque los comentarios al final es algo que también hay que mantener.
Y eso es una cosa que hay que tener en cuenta.
Por eso sí que se puede pecar de exceso y puede ser interesante no pecar de exceso.
Porque lo peor que te puede pasar con un comentario es que lo que comenta no sea verdad.
Eso es lo peor y lo más peligroso de los comentarios.
No tanto por decirle, ah, bueno, es un comentario y tal y que tenga ruido, sino porque sea mentira.
Y eso es muy peligroso, ¿eh?
Claro, porque quedan obsoletos y engañan.
Ahí es donde está el peligro.
Entonces, hay que entender que los comentarios no deja de ser código que hay que mantener.
Solo que simplemente es un comentario que no se ejecuta.
Pero al final, pues, hay que mantenerlos y asegurarse que realmente funcionen correctamente.
No hay nada más peligroso que un comentario que mentira.
Así que ténganlo en cuenta, ¿eh?
Acabo de salir de almorzar y aprovechando para ver al midulife, hablando de comentar código.
Estoy eliminando un poco que lo vea y te dios.
Con decirte que hay comentarios con esta función parece que, claro, esos son comentarios que no añaden.
Y obviamente hay que intentar que el código sea autoexplicativo.
Otra alternativa muy interesante a los comentarios son los tests.
Aunque la gente no se lo crea, pero también documentan el código y qué hacen las funciones.
Porque los tests, quieras o no, tienen que tener títulos, descripciones, qué hace la función, cuál es el output esperado y este tipo de cosas.
Así que los tests también son bastante interesantes para documentar qué es lo que hace el código.
Para que lo sepáis, ¿eh?
Que luego no queréis hacer test.
A mí me parece una herramienta muy interesante para entender cómo funcionan las cosas.
Así que ahí lo tenéis.
Pero, sobre todo, os digo una cosa.
No seáis de blanco o negro y no entréis al trapo con...
Es que los comentarios están bien, están mal, es no sé qué, es no sé cuánto.
Yo qué sé.
Todo tiene un caso y hay que entender el contexto.
Y yo creo que lo mejor es que toda herramienta puede ser bien usada y mal usada.
Solo que hay que saber cuándo y cómo utilizarlo correctamente.