524 meneos

Es importante comentar bien el código  imagen

www.fantasmitas.com/2009/12/01/154-programador/ 
por Nirgal el 01-12-2009 20:32 UTC publicado el 01-12-2009 23:25 UTC

Esto es lo que pasa cuando a alguien realmente literal le pides que el código de un programa esté bien comentado. (Hace falta hacer click sobre la imagen para verla en tamaño grande)

etiquetas: programación, código, comentarios, programador
negativos: 0   usuarios: 277   anónimos: 247  
compartir:  twitter  facebook  tuenti  
75 comentarios ocio, friqui karma: 571
  2. #2   rem ¿comenta? ¿que es comentar?
    ' hace años que no se comentan las lineas.
    // muy bueno
    59  votos: 6   link
    el 01-12-2009 20:41 UTC por Cortocircuitos Cortocircuitos
  3. #3   Lo de la repeticion en el debugger me ha matado xD
    245  votos: 29   link
    el 01-12-2009 20:42 UTC por eloso eloso
  4. #4   muy muy bueno, y los iconos de la pagina , se salen
    31  votos: 2   link
    el 01-12-2009 20:45 UTC por manjsc manjsc
  5. #5   LOL Está genial! xD
    15  votos: 1   link
    el 01-12-2009 20:48 UTC por zerial zerial
  7. #7   /* Me ha encantado */
    175  votos: 20   link
    el 01-12-2009 20:52 UTC por miau miau
  8. #8   #7 Todos los comentarios de meneame vienen comentados de serie.
    33  votos: 3   link
    el 01-12-2009 21:18 UTC por sorrillo sorrillo
  9. #9   <!-- Que bueno -->
    80  votos: 7   link
    el 01-12-2009 21:21 UTC por angelitoMagno angelitoMagno
  10. #10   xD xD xD xD
    7  votos: 0   link
    el 01-12-2009 21:42 UTC por pejotadb pejotadb
  11. #11   Me habría hecho gracia si no me hubieran contado el final en el título del post. ¿Tu no serás traductor de títulos de películas al español?
    151  votos: 18   link
    el 01-12-2009 22:13 UTC por kanduman kanduman
  12. #12   Comentar el código es como lavar el cuarto de baño: nadie quiere hacerlo, pero cuando se hace, provoca una buena sensación para usted y sus visitantes.
    300  votos: 35   link
    el 01-12-2009 22:15 UTC por iRiku87 iRiku87
  13. #13   Que buena
    6  votos: 0   link
    el 01-12-2009 22:20 UTC por casusbelli casusbelli
  14. #14   #2 rem. OMG que recuerdos.
    30  votos: 2   link
    el 01-12-2009 22:30 UTC por radurdin radurdin
  15. #15   Ja, ja, sí. Pero no olvidemos que la rechifla esta procede de una mala traducción que casi todos hemos contribuido a propagar: el ‘to remark inglés’ no debería haber pasado al español, en este contexto, como ‘comentar’, sino como ‘anotar’
    Y, dicho esto... :-D
    37  votos: 3   link
    el 01-12-2009 22:45 UTC por senador senador
  16. #16   //grande//
    16  votos: 1   link
    el 01-12-2009 22:45 UTC por Akai Akai
  17. #17   ;Está bastante bien, coincido con #11.
    15  votos: 1   link
    el 01-12-2009 23:06 UTC por www.bromarca.com www.bromarca.com
  18. #18   # OMG, mezclar fútbol con programación, esto debe ser peor que lo del LHC ese
    34  votos: 3   link
    el 01-12-2009 23:18 UTC por Genko Genko
  19. #19   Ahora que hagan uno sobre indentar y lo jodido que es leer código de alguien que no indenta. ¡Qué suplicio!
    29  votos: 3   link
    el 01-12-2009 23:28 UTC por emenegro emenegro
  20. #20   Por estas pequeñas cosas Meneame es un mundo aparte...
    15  votos: 1   link
    el 01-12-2009 23:31 UTC por Meik Meik
  21. #21   -- Que bueno lo de inserta, inserta, ... excepcion sql!
    22  votos: 2   link
    el 01-12-2009 23:31 UTC por prejudice prejudice
  22. #22   Está caído...
    16  votos: 0   link
    el 01-12-2009 23:34 UTC por araujo araujo
  23. #23   la verdad es que está muy bien
    ese y el nº 146 "Dorando la píldora"

    #22 ahora no
    #22 ahora si
    #22 ahora no... va por momentos
    #22 ¿ves? ahora si otra vez
    51  votos: 6   link
    el 01-12-2009 23:38 UTC por malacaton malacaton
  24. #24   Ouch ! y yo dando forms! xD
    6  votos: 0   link
    el 01-12-2009 23:42 UTC por Shrewd Shrewd
  25. #25   Quiero... leerlo... AAAAARG
    9  votos: 0   link
    el 01-12-2009 23:44 UTC por --29006-- --29006--
  26. #26   Si el código necesita ser comentado, es que necesita ser reescrito.
    5  votos: 2   link
    el 01-12-2009 23:45 UTC por figus_black figus_black
  27. #27   Yo también quiero ver! :-D

    Pero la página está caida :-P
    6  votos: 0   link
    el 01-12-2009 23:46 UTC por david5 david5
  28. #28   #19 Para eso se inventaron los auto-indentadores. Yo lloro cada vez que un profesor o compañero me pasa código, por eso en cuanto me llega algo en C++ o Java le paso el astyle: astyle.sourceforge.net/
    19  votos: 1   link
    el 01-12-2009 23:48 UTC por rasca rasca
  29. #29   ¿Alguien tiene un enlace en caché o algo? No me carga :-( .
    24  votos: 1   link
    el 01-12-2009 23:51 UTC por N4D13LOLZ N4D13LOLZ
  30. #30   Muy bueno. Me recuerda a Gila y la operacion de riñón:

    www.ivoox.com/gila-operacion-rinon-audios-mp3_rf_144037_1.html
    15  votos: 1   link
    el 01-12-2009 23:51 UTC por --4067-- --4067--
  31. #31   #29 me uno a la propuesta
    24  votos: 1   link
    el 01-12-2009 23:52 UTC por sam2001 sam2001
  32. #32   Hacía mucho tiempo que no tenía tanta expectación... llevo un porrón de rato intentando verlo solamente por cabezonería... carga la página horriblemente lenta... no recuerdo tanto sufrimiento desde esas cargas de jpegs subiditos de tono que era eterna con 28'8 kbps (yo es que no viví los 14'4, no soy tan viejo).

    Ahora mismo espero el mejor chiste del mundo... si no muero de risa me sentiré decepcionado.
    33  votos: 3   link
    el 01-12-2009 23:52 UTC por Caesarsaz Caesarsaz
  33. #33   #29 y #31 enlace directo a la imagen: www.fantasmitas.com/wp-content/uploads/2009/12/f_m_154.png
    33  votos: 2   link
    el 01-12-2009 23:56 UTC por sam2001 sam2001
  34. #34   #33 Gracias :-D .

    Dioooooooooos, qué mala es :-S :S :-S . #32, lo siento, pero te vas a sentir decepcionado xD xD .
    10  votos: 0   link
    el 01-12-2009 23:56 UTC por N4D13LOLZ N4D13LOLZ
  35. #35   #29, #31 imgur.com/VmfR2.png
    32  votos: 4   link
    el 01-12-2009 23:57 UTC por Blaxter Blaxter
  36. #36   Me siento decepcionado y mis amigos apesadumbrados. Ni yo tuve lo que esperaba ni los que me rodean tuvieron lo que desean.

    Muerte, otra vez será...
    16  votos: 1   link
    el 01-12-2009 23:57 UTC por Caesarsaz Caesarsaz
  37. #37   Mola :-)
    9  votos: 0   link
    el 01-12-2009 23:57 UTC por Lito Lito
  38. #38   Por qué no usamos una cache para los links, como por ejemplo coral? No más links caídos. Y menos? Menos sí.
    6  votos: 0   link
    el 01-12-2009 23:59 UTC por --6043-- --6043--
  39. #39   cinco mentarios
    6  votos: 0   link
    el 02-12-2009 00:04 UTC por --6043-- --6043--
  40. #40   FFFFFFFFFOOOOOOOOOOOOOOOOOORRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR del CSV-Subersion !!!!!!!!!!
    8  votos: 0   link
    el 02-12-2009 00:13 UTC por RaiderDK RaiderDK
  41. #41   Forges genial como siempre

    Oh wait!
    15  votos: 1   link
    el 02-12-2009 00:18 UTC por --25105-- --25105--
  42. #42   # Qué malo xD
    6  votos: 0   link
    el 02-12-2009 00:21 UTC por --156823-- --156823--
  43. #43   #28 #19 A mi me entra sarpullido cuando alguien identa con espacios en vez de con tabulaciones. No puedo con ello, para leer no pasa nada, pero si tienes que tocar código... aarrrrggg
    6  votos: 0   link
    el 02-12-2009 00:30 UTC por --155086-- --155086--
  44. #44   Le falta un terrorífico....

    TODO:
    6  votos: 0   link
    el 02-12-2009 00:32 UTC por ZuL ZuL
  45. #45   Pero de verdad ¿para programar una base de datos hace falta comentar el código? no me extraña que os paguen 800 euros de mierda.

    otra cosa sería software para hacer simulaciones fisicas en 3d en ensamblador, entonces de vez en cuando hay que poner un comentario, pero ¿programillas que lo unico que hacen es mandar llamadas a una base de datos?

    jajajajaj
    8  votos: 2   link
    el 02-12-2009 00:37 UTC por Professor Professor
  46. #46   de los mejores chistes que he visto en mi vida xD xD
    7  votos: 0   link
    el 02-12-2009 00:54 UTC por okeen okeen
  47. #47   #45 ¡Qué joputa eres! xD

    ¿por cierto, tienes algún troll comunista? Es que este "Professor" Francófilo ya comienza a ser un tanto cansino...
    11  votos: 0   link
    el 02-12-2009 00:58 UTC por Golan_Trevize Golan_Trevize
  48. #48   Yo conocia esta
    www.fantasmitas.com/2009/09/06/142-maestro-jedi/
    11  votos: 0   link
    el 02-12-2009 01:18 UTC por visualito visualito
  49. #49   Hola, soy la variable de la función alcorcon...
    7  votos: 0   link
    el 02-12-2009 01:30 UTC por ronko ronko
  50. #50   #45 así que en asm pones "de vez en cuando" comentarios? xD
    Miedo me da leer un codigo tuyo en asm o en C...
    19  votos: 2   link
    el 02-12-2009 01:48 UTC por --155086-- --155086--
  51. #51   % #43 Pues en muchas normas de estilo se recomienda tabular con espacios xD

    % Y me temo que con razón... En Eclipse, por ejemplo, si usas el tabulador lo que ocurre es que se
    % va alineando el texto con columnas prefijadas. Por lo que el tabulador no equivale a un número
    % exacto de espacios, sino a "los que falten para llegar a X columna". Lo mismo pasa en otros IDEs.
    % Cuando luego llegas, y tienes que abrir el código en vim... te abres las venas, directamente,
    % porque se muestra totalmente mal identado.

    % PD: En Eclipse, por cierto, se puede especificar que se tabule con espacios (es decir, cuando
    % tú pulsas Tab, él mete espacios) y los maneja estupendamente, puedes incluso seguir usando
    % Mayus+Tab sin problemas. Es la mejor opción :-)

    % PPD: Esto es un comentario de MATLAB, que ese aún no lo habéis puesto :-P
    7  votos: 0   link
    el 02-12-2009 05:38 UTC por jmpep jmpep
  52. #52   #45: lo tuyo, sin comentarios :-P

    la persistencia es solo un paso en un programa. la algoritmia suele necesitar comentarios. Primero, para que dentro de dos meses, cuando te pidan una modificación (o se la pidan a un compeñero), te acuerdes de qué iba el fregado. Segundo, por facilitar la didáctica (un código bien indentado y comentado puede srer útil para que otros compañeros aprendan y se familiaricen con un lenguaje y con las best-practices de programación. Tercero, suele ser útil cuando intentas localizar código en proyectos grandes (algo tan sencillo como un comentario con el id de error que has solucionado soluciona muchos dolores de cabeza. Cuarto, suele ser necesario comentar como mínimo, minimísimo, las cabeceras, para que si alguien utiliza tu código sepa qué son los parámetros...
    32  votos: 3   link
    el 02-12-2009 06:46 UTC por enderwiggins enderwiggins
  53. #53   muy bueno el chiste
    7  votos: 0   link
    el 02-12-2009 06:54 UTC por Canaca Canaca
  54. #54   #19 Por eso me enamore de python...
    14  votos: 1   link
    el 02-12-2009 07:54 UTC por dreierfahrer dreierfahrer
  55. #55   #26 me has recordado este BRUTAL post de the daily wtf:

    thedailywtf.com/Articles/CodeThatDocumentsItselfSoWellItDoesNotNeedCom
    7  votos: 0   link
    el 02-12-2009 07:57 UTC por dreierfahrer dreierfahrer
  56. #56   #28 lo que mola es que si no indentas NO COMPILE, y te de un error y te diga: 'indenta, atontao' :-)
    7  votos: 0   link
    el 02-12-2009 07:58 UTC por dreierfahrer dreierfahrer
  57. #57   Jajaja SQLException, que injusticiaaaaaaaa!!
    6  votos: 0   link
    el 02-12-2009 08:21 UTC por Shirouhana Shirouhana
  58. #58   #26 Me gustaria ver un millon de lineas de codigo sin comentarios....

    Y me gustaria verte reescribirlo... con infinitos monos aporreando infinitos teclados, a poder ser
    13  votos: 1   link
    el 02-12-2009 08:31 UTC por dreierfahrer dreierfahrer
  59. #59   COBOL RULES!!!

    Ahora coñas aparte "El código ha sido dificil de programar, así que tiene que ser dificil de leer"
    9  votos: 0   link
    el 02-12-2009 08:43 UTC por MycroftHolmes MycroftHolmes
  60. #60   #26 +1, todas las buenas prácticas indican que el código debe hablar por si solo, excepto en casos en los que la implementación del algoritmo lo requiera, para mayor claridad de lectura.

    Un código que necesite de muchos comentarios para ser entendido, no es un buen código
    6  votos: 0   link
    el 02-12-2009 08:44 UTC por Markinos Markinos
  61. #61   #43 Es mejor práctica indentar con espacios, ya que en todos los entornos los tabuladores no aparecerán con la misma longitud, pero los espacios sí.

    Los tabuladores son más cómodos, por eso herramientas como Eclipse permiten que tú teclees tabulador e inmediatamente sea reemplazado por 4 o n espacios.
    7  votos: 0   link
    el 02-12-2009 08:50 UTC por Jarke Jarke
  62. #62   #60 Si el codigo solo lo ves y solo lo tocas tu y no vas a hacer nada mas en tu vida que mirar y tocar ESE codigo puede que tengas razon...

    Y si el programa no es demasiado grande, claro...

    Nadie es tan bueno como para no necesitar comentarios en 5.000.000 de lineas y aunque lo fuera seguro que no esta solo y puede que a alguien que trabaje con el le vengan bien los comentarios, ademas no cuesta nada, clarifica y se puede documentar el codigo mucho mas facil...

    Que perra os ha entrado... os molestan los comentarios? os muerden los cojoncillos?
    19  votos: 2   link
    el 02-12-2009 09:11 UTC por dreierfahrer dreierfahrer
  63. #63   #47 el comunismo! interesante.
    6  votos: 0   link
    el 02-12-2009 11:36 UTC por Professor Professor
  64. #64   #43 #51 #61

    A mi personalmente tabular con espacios me parece una reminiscencia de cuando se manipulaba codigo con herramientas de los años 80, hoy en dia todos los editores decentes te permiten trabajar con funciones avanzadas tanto con tabuladores como con espacios, en cambio, usar el marcador de tabulacion como marcador semantico de indentacion me parece mucho mas acertado, no solo por lo obvio de su uso, si no por lo que apunta #61, en diferentes entornos estos simbolos pueden ser dibujados de diferentes maneras, lo que en mi pueblo se llama 'personalizacion' y es una ventaja, no un inconveniente.
    6  votos: 0   link
    el 02-12-2009 11:58 UTC por oxelo oxelo
  65. #65   #64 #51 #61
    El problema es que es bastante incómodo trabajar con el.
    Por ejemplo, si te toca borrar un bucle cualquiera que implica unas cuantas lineas de código identadas, te toca borrar espacios, mientras que si has tabulado, solo tienes que quitar una tabulación por cada linea.
    6  votos: 0   link
    el 02-12-2009 12:29 UTC por --155086-- --155086--
  66. #66   #55, #58, #60, #62 Que era broma por dios, que daño ha hecho lo de ironic=off y demás chorradas, ahora nadie pilla las bromas si no se las mastican....¡y encima uno me vota negativo! sois como críos.
    6  votos: 0   link
    el 02-12-2009 13:22 UTC por figus_black figus_black
  67. #67   que buena viñeta!!
    6  votos: 0   link
    el 02-12-2009 13:57 UTC por Estopeño Estopeño
  68. #68   Si no dejas "notas" en él, el codigo fuente puede no ser facilmente interpretado por otra persona que lea dicho codigo fuente... precisamente por eso mucha genta no deja "notas" en el codigo fuente... para que los demas no lo entiendan facilmente. Para los que no le cojan... "hacerse imprescindible", "es mi codigo, que se piii", etc etc

    A las malas se puede entender un codigo sin anotaciones, pero cuesta trabajo y tiempo. Y no vayas a explicarle eso a tu jefe ;)
    6  votos: 0   link
    el 02-12-2009 13:58 UTC por chubasco chubasco
  69. #69   Se me olvidaba un ejemplo de otro tipo.

    Llega un programador competente y le dice el empresario hazme este tipo de programa. Va el buen hombre y lo hace. Funciona perfecto y todo completamente "comentado"!!!!

    Muy bien Manolito... pues ya te puedes ir a la puta calle! JAJAJA

    Contrata a Bartolo el limitado y este, gracias a tus "notas", puede ir parcheando tu programa :-P Y mas barato, oiga ;)
    6  votos: 0   link
    el 02-12-2009 14:05 UTC por chubasco chubasco
  70. #70   #69: ¿y por eso es preferible hacer mal tu trabajo? ¿porque el empresario sea un hijo de puta? ¡Bravo! :-D
    17  votos: 1   link
    el 02-12-2009 15:34 UTC por enderwiggins enderwiggins
  71. #71   #66 Y TU MAS!

    #68 Ye tenia un 'jefe' (superior a mi, mas bien) que para hacerse 'imprescindible' me ocultaba informacion... todo un show cuando cayo de baja...

    #69 Pues te vas a hacer otro programa cojonudamente a otro lado... si eres bueno en lo tuyo estate tranquilo que valoraran tu trabajo...
    7  votos: 0   link
    el 02-12-2009 17:08 UTC por dreierfahrer dreierfahrer
  72. #72   #64 Hay entornos en los que los tabuladores no tienen la longitud que esperas, y es muy fácil que haya algún espacio mezclado entre ellos, ya que en muchos editores son invisibles. Ello ocasiona que no se produzca un efecto de "personalización", sino que todo quede mal indentado.

    Y lo digo porque me ha pasado.
    7  votos: 0   link
    el 02-12-2009 17:09 UTC por Jarke Jarke
  74. #74   #65 En Eclipse por ejemplo no tienes que andar quitando espacios. Pulsas Mayus+Tab y él quita los espacios que correspondan a una tabulación.
    7  votos: 0   link
    el 03-12-2009 04:25 UTC por jmpep jmpep
  75. #75   En Eclipse haces Control+Shift+t y te autoindenta el código. Característica totalmente infrautilizada y super útil. Cuando me toca pegarme con código de otro, es lo primero que hago. Hace el trabajo mucho más fácil.
    7  votos: 0   link
    el 04-12-2009 00:57 UTC por --7103-- --7103--
comentarios cerrados

menéame