Mostrando entradas con la etiqueta código. Mostrar todas las entradas
Mostrando entradas con la etiqueta código. Mostrar todas las entradas

lunes, 20 de enero de 2014

361 - tipos de comentarios de código



Siempre he sido partidario de que los comentarios en código no deberían ser necesarios, a excepción de las cabeceras (explicar el uso, dependencias y demás en una clase me parece necesario); el código debe ser sencillo, acotado y los métodos, cortitos (no en el sentido de Paquirrín; en el sentido de breves, leñe). A veces no es posible, hay campos del desarrollo que son complejos, y qué cojones; a veces sabes que nadie va a leer los diagramas UML, la documentación de arquitectura... o directamente, no hay.  O a veces, heredas un código ilegible y necesitas hacerte a la idea de qué cojones hace y escribes comentarios para aclararte tú mismo, antes de respirar hondo, ir a ver a tu jefe, decirle que te vas a dedicar una semana a refactorizar un código de mierda que funciona para convertirlo en un código legible que funciona, y luego largarte montado en un unicornio dorado.

Por supuesto, los comentarios proporcionan otras cosas: por ejemplo, desahogo o risas :-)... contad vuestras experiencias; estoy seguro de que superarán a la tira POR MUCHO. xD




¿quieres leer más tiras? Entra en el listado de tiras y escoge!

Puedes usar esta tira libremente,
cumpliendo tan solo esta licencia CC:
Creative Commons License