Historias
Slashboxes
Comentarios
 

Login Barrapunto

Login

[ Crear nueva cuenta ]

Encuesta

Encuesta En el código fuente, uso los comentarios
Nunca. Y además, las variables son todas foo, bar y baz (con números si es pertinente)
Al principio de cada sección
Una al principio del fichero con el nombre del fichero y punto
Uso "literate programming" y escribo poesías en los comentarios
Comento cada línea, cada variable, y cada comentario
Los comentarios son como un making off del programa. "Estaba yo en mi casa, cuando me pregunté: ¿cómo se llamará esta variable de bucle?
¿Mande? ¿Comentarios?
Al encuestador le voy a comentar yo un par de cosas
[ Resultado | Encuestas ]
Comentarios:133 | Votos:1420

Palabras clave en el código

editada por JJ el 23 de Noviembre 2004, 08:19h   Printer-friendly   Email story
desde el dept. NO-DEBERÍAS-ESTAR-AQUÍ
Cek pregunta en su Ceklog sobre las palabras clave que se suelen encontrar en el código: OJO, ARRÉGLAME, KLUDGE, y cosas por el estilo; los comentaristas añaden algunas más. Ya puestos, podemos recordar algunas frases curiosas en el código del kernel o las veces que se repite joder en el código fuente de Windows. Está claro que los buenos programadores nunca ponen comentarios, pero ya que hay que ponerlos, ¿qué soléis usar?

Este hilo ha sido archivado. No pueden publicarse nuevos comentarios.
Mostrar opciones Umbral:
Y recuerda: Los comentarios que siguen pertenecen a las personas que los han enviado. No somos responsables de los mismos.
  • ¿Buenos programadores?

    (Puntos:3, Informativo)
    por pobrecito hablador el Martes, 23 Noviembre de 2004, 08:57h (#392825)
    Eso de que los buenos programadores nunca ponen comentarios...¿donde aprendiste a programar? Para nivel SIL4 de la ISO9002 es EXIGENCIA que el código fuente esté comentado, además, sin comentarios, ¿como pones la cabecera de las funciones o los ficheros? Los comentarios en línea ayudan, y mucho; casi cualquier persona que use el vi -por ejemplo- sabe que encima de un corchete en modo comando si pulsas '%' vas a su corchete colateral -digamosló así, sin embargo ayuda bastante poner "cierre del chequeo de parametros"... Los comentarios son muy útiles en casi cualquier circunstancia, sino no existirían, ¿no crees?
  • frases

    (Puntos:4, Divertido)
    Yo empezé un proyecto yo solito, y como programaba a horas intespectivas ponía cualquier cosa que ponía en el principio de los ficheros, cachos de canciones de extremoduros, los suaves, marea, cualquier cosas.
    Seis meses después contrataron a un Polaco(vease natural de Polonia) y se dedico a traducir los comentarios....
    Me moría de vergüenza...
    • Re:frases de nikon (Puntos:2) Martes, 23 Noviembre de 2004, 09:16h
      • Re:frases de zarshisha (Puntos:2) Martes, 23 Noviembre de 2004, 09:51h
    • Poeta Frustrado de pobrecito hablador (Puntos:1) Jueves, 25 Noviembre de 2004, 03:58h
    • Re:frases de wizord (Puntos:1) Viernes, 26 Noviembre de 2004, 14:10h
      • Re:frases de israelviana (Puntos:1) Sábado, 27 Noviembre de 2004, 09:51h
        • Re:frases de musg1 (Puntos:1) Lunes, 29 Noviembre de 2004, 09:35h
    • 1 respuesta por debajo de tu umbral de lectura actual.
  • Offtopic

    (Puntos:2)
    por samsaga2 (5886) el Martes, 23 Noviembre de 2004, 09:39h (#392863)
    ( http://barrapunto.com/ )
    Me lo estoy imaginando, solo me pasa a mi pero no veo un monton de comentarios que habia leido en esta noticia.
    --
    Pa que? Pa cagala?
  • no comment

    (Puntos:1)
    por galleguio novato (7274) el Martes, 23 Noviembre de 2004, 09:54h (#392872)
    ( http://barrapunto.com/ | Última bitácora: Viernes, 24 Febrero de 2006, 07:35h )

    Recuerdo que una profesora que tuve yo, habia estado trabajando en el departamento de informática de un Banco como programadora. Resulta que ella había entrado para sustituir a un chico que se había marchado. Como en el Banco siempre les pedian las cosas para anteayer, pues no les daba tiempo a comentar el codigo, y a sus superiores no les importaba, pues lo importante es que el codigo estuviese listo para ya. Lo dicho, este hombre se marcho del banco, dejando miles de lineas de codigo sin comentar, lo cual obligo a poner a dos personas durante mucho tiempo para descifrar los programas. A partir de ese día, todo el mundo tenia obligacion de comentar el codigo, y pobre del que no lo hiciese.

    --

    somos como Dios nos hizo, y alguno somos peor (Siniestro Total)

  • Y es que somos vagos

    (Puntos:4, Interesante)
    por samsaga2 (5886) el Martes, 23 Noviembre de 2004, 10:14h (#392889)
    ( http://barrapunto.com/ )
    Por regla general los programadores solemos ser muy vagos y no nos gusta escribir nada que se salga fuera del codigo (solo hay que ver la cantidad de software libre sin documentacion).

    Tambien hay que tener en cuenta que hay gente que escribe los programas de forma tan clara que escribir un comentario seria redundante. No creo que sea coincidencia que los programas mas "oscuros" (sinonimo del mal programado) sean siempre los que necesitan mas comentarios.
    --
    Pa que? Pa cagala?
    • Re:Y es que somos vagos

      (Puntos:4, Interesante)
      por ochoak (16700) el Martes, 23 Noviembre de 2004, 12:04h (#392955)
      ( Última bitácora: Viernes, 02 Diciembre de 2005, 13:38h )
      Por regla general los programadores solemos ser muy vagos y no nos gusta escribir nada que se salga fuera del codigo (solo hay que ver la cantidad de software libre sin documentacion
      Eso es cierto, los códigos que más he comentado siempre han sido los de la universidad, y más que nada porque me obligaban...

      Tambien hay que tener en cuenta que hay gente que escribe los programas de forma tan clara que escribir un comentario seria redundante.
      Ahí no estoy de acuerdo, por muy claro que quede y por muy estructurado que esté, creo que siempre es recomendable añadirle comentarios. Y no es simplemente por hacerle un favor al que tenga que trabajar con él mas tarde, sino por ahorrate tiempo a ti mismo cuando tengas que revisarlo.
      [ Padre ]
  • ¿por donde iba?

    (Puntos:1)
    por felipelotas (9998) <f_lotasNO@SPAMyahoo.es> el Martes, 23 Noviembre de 2004, 10:23h (#392894)
    ( http://barrapunto.com/ | Última bitácora: Miércoles, 06 Julio de 2005, 18:44h )
    Para no perder el horizonte cuando te enfrascas en un código de miles de líneas y la cosa te dura más de un día, yo utilizo este simple comentario: akimeando
    --


    (2p2+k2ya+a2).1/5=kkdkdt
  • Anecdota

    (Puntos:3, Interesante)
    por rguiu (15794) el Martes, 23 Noviembre de 2004, 10:26h (#392896)
    ( http://barrapunto.com/ | Última bitácora: Miércoles, 02 Julio de 2008, 21:45h )

    Una vez tube que hacer un "hack rapido" de algo que habia sido corregido mil veces, el cliente lo cambiaba o mil cosas. Lo hice en 10 minutos, pero deje una nota para volver a mirarlo y reescribir por completo la clase. Dentro de la Nota escribi algo asi(no recuerdo exactamente): "Dirty hack call 911, raul"

    Ese dia, o el dia despues cai malo, fui al hospital 3 meses, y volvi al trabajo 5 meses despues. No volvi a trabajar en ese proyecto, pero pregunte a alguno de los que seguian alli si habian arreglado esa clase de una vez por todas... me dijero, si si, no te preocupes....

    El codigo se entrego al cliente.... y azaraes del destino mi novia empezo a trabajar para ellos. Imaginad, "Oye, el Raul este, es TU Raul" fue la pregunta cuando encontraron ese comentario.

  • Te habrás quedado agusto...

    (Puntos:3, Interesante)
    por I0nI0n (12021) <ionionzoo AT jabber DOT org> el Martes, 23 Noviembre de 2004, 10:34h (#392901)
    ( http://www.ionionzoo.tk/ | Última bitácora: Jueves, 26 Mayo de 2005, 15:07h )
    Está claro que los buenos programadores nunca ponen comentarios

    Para nada, lo que está claro son 2 cosas:

    1. Los buenos programadores ponen comentarios, los justos para que cualquiera que no esté familiarizado con el programa en cuestión pueda hacerse una idea rápida de su funcionamiento, es como si te vendo una lavadora y no te doy las instrucciones porque como la lavadora es tan buena y tu tan listo no hacen falta ;-)

    2. Hay que cuidar más los comentarios subjetivos de las noticias de portada, ya tenemos los hilos de comentarios para visiones personales de la noticia en cuestión :)

    --

    --
    El imperio de las Luces [terra.es]
  • Comentarios obscenos e inmorales

    (Puntos:2, Divertido)
    Normalment pongo comentarios que no aclaran nada y ademas ayuden a aumentar la confusión de quién los lee. Suelo emplear frases crípticas y nombres de variable esotericos. Las reacciones más comunes son frases del estilo:
    Entendia perfectamente el programa hasta que me leí los comentarios
    ¿Son los comentarios de otro programa?
    ¿Estabas borracho cuando hiciste el programa?
    9 de cada 10 programadores recomiendan no leer los comentarios de Spike. El restante todavía esta intentando entenderlos.
    --


    Julio César fue víctima de la violencia latina.
    • ejem de NeoSng (Puntos:1) Miércoles, 24 Noviembre de 2004, 14:45h
  • Comentarios hay muchos y muy buenos

    (Puntos:3, Divertido)
    por coder (9326) el Martes, 23 Noviembre de 2004, 10:47h (#392908)
    ( http://www.fluzo.org/ )
    Un par de ejemplos de código de proyectos requete-heredados de subcontratas:

    "// Esto esta forzado a piñon. Es una mierda y se jode la generalidad. NO LO TOCO"

    /*FUNCION COPIADA DE LA PRACTICA DE JOAQUIN EL DE PRIMERO: NO SE SU USO NI COMO FUNCIONA PERO CONECTA CON LA BD Y SACA REGISTROS*/

    Ambos verídicos y de proyectos por los que se han facturado varios miles de Euros.

    Yo he llegado a una conclusión: el código da igual, al cliente sólo le importa el diseño. Y los jefes lo saben, vaya si lo saben.
    --

    --
    atrapado por tu moda [fluzo.org]
  • Comentarios? Si!

    (Puntos:1)
    por LcTrC (16520) <electroceaARROBÁterra.es> el Martes, 23 Noviembre de 2004, 11:01h (#392912)
    ( http://www.barrapunto.com/ )
    Pos nada, que los comentarios son imprescindibles, no a lo mejor a código trivial, pero si donde la comprensión es dificil. El único problema es que al "jefe" no le interesa la documentación, por lo menos al mio, hasta que le piden la documentación, entonces me trago unas semanas "a trapo" y todo solucionado.
    El problema es de los jefes que no incluyen en el presupuesto la documentación, y para la estimación de costes te pregunta, "¿esto cuanto tardas?", a lo que tu previsor (y realista) haces una estimación pesimista. A él no les gustará pero tu "ya lo advertiste".
    Para cuando un Colegio de Informáticos que legisle nuestra actividad!!!
  • No comments

    (Puntos:1, Inspirado)
    por pobrecito hablador el Martes, 23 Noviembre de 2004, 11:05h (#392914)
    "Los buenos programadores no comentan"

    Calla, calla, que en mi curro se lo creen y no veas lo putas que las paso YO para entender SU código. El otro día me felicitaron por un programa que escribí yo hará cosa de un año, "está muy bien comentado" me decían. Cabrones, estaba comentado, ya está.

    Tengo aquí un par de funciones con las que llevo una semana peleándome. Le he preguntado a su autor (compañero de curro) "¿cómo funcionan?" y me dice "es que eso lo escribí hace mucho tiempo y ya no me acuerdo. Además, el código lo saqué de otro lado y me limité a adaptarlo para que funcionase". Vale, ni el que lo ha escrito sabe cómo va y no hay comentarios por ningún lado. Genial. (Además, el tío no se acuerda de ello pero estoy seguro que entonces estaba practicando para uno de esos concursos de programación ofuscada.)

    Mecagoentóoooooo
  • por toci (4853) el Martes, 23 Noviembre de 2004, 11:13h (#392916)
    ( Última bitácora: Domingo, 05 Diciembre de 2010, 22:01h )
    Conozco de algún caso en el que un print del estilo "Hola, capullo" escrito al principio de una subrutina se ha escapado y lo ha llegado a ver un cliente final al ejecutarse el programa ...
  • La pregunta clave

    (Puntos:4, Informativo)
    por trovador (9832) el Martes, 23 Noviembre de 2004, 11:16h (#392918)
    ( http://barrapunto.com/ )
    Hay gente que cree que tiene que describir en los comentarios lo que hace el código. Leer un fichero de cierto tamaño comentado por una de esas personas es insufrible, pues vas leyendo lo mismo dos veces en paralelo.
    a = b * 2; /* asigno a "a" el valor de "b" multiplicado por dos */
    Si notas la profunda estupidez de ese comentario, estás en el camino para entender por qué "Abro una conexión con base de datos", "Cierro el fichero" y similares son comentarios pésimos.

    ¿Qué es lo que hay que poner en un comentario? La pregunta que tienes que hacerte es:

    ¿Por qué?

    O sea ¿por qué he hecho esto... que no es evidente por sí mismo? Hay que ponerse en el lugar del que va a leer el código (que puede ser uno mismo) y señalar las partes en que se hace algo que no se entiende a primera vista.

    Aparte de eso, es conveniente escribir descripciones detalladas para cada módulo, clase y función que se escriba, pero eso es posible hacerlo "asíncronamente", es decir antes o después de escribir el código, mientras que lo del por qué es conveniente hacerlo a la vez.

  • Pseudocódigo

    (Puntos:1)
    por elpresi (7708) <bioquimicguay@borraesto.yahoo.es> el Martes, 23 Noviembre de 2004, 11:56h (#392945)
    Yo tengo la costumbre de escribir en una espécie de pseudocódigo cada una de las funciones, que posteriormente "traduzco" a lo que toque. Los comentarios en mis programas suelen ser el pseudocódigo. Cómo cada linea de pseudo-c. se corresponde con varias de C, al final queda explicado que hace cada bloque.
    Por eso hay veces que queda:

    //Y cierro el fichero
    fichero.close( ) ;
  • Pueees...

    (Puntos:1, Inspirado)
    por pobrecito hablador el Martes, 23 Noviembre de 2004, 12:14h (#392960)
    La verdad es que los comentarios tipicos que uso son cuando por lo que sea tengo q dejar una parte de codigo a medias en contra de mi voluntad... como por ejemplo

    /* Seguir aqui, estaba haciendo tal cosa, funciona hasta tal punto pero falla en nosedonde */

    O aclaraciones para quien pueda venir despues en caso de que me den la patada...

    /* Si quieres saber como seguir, me aflojas pasta y te lo cuento */
    ... uy no perdon, lapsus...
    /* Esto esta hecho de tal forma porque me parecio mejor que de tal otra */ :)

    Por ultimo, y aunque parezca un poco estupido, suelo delimitar zonas determinadas de codigo con comentarios a modo de etiquetas de inicio y fin para poder navegar entre ellas rapidamente... en plan

    /* INICIO apertura de archivo de config */

    /* FIN apertura de archivo de config */

    Y bueno, comentarios aclaratorios para uno mismo, que el cerebro no esta tan lucido unos dias como otros, y lo que hoy haces con soltura mañana te puede parecer algo ilogico y totalmente abstracto :D :D :D :D O eso, o que deberia intentar no sentarme a programar nada mas levantarme :D :D :D
    • Re:Pueees... de samizdat (Puntos:2) Martes, 23 Noviembre de 2004, 21:12h
  • All the comments I need

    (Puntos:4, Divertido)
    /* Real programmers don't comment their code.
    It was hard to write, it should be hard to understand. */

    */ Real computer scientists don't comment their code. The identifiers are
    so long they can't afford the disk space. */

    /* Real software engineers don't debug programs, they verify correctness.
    This process doesn't necessarily involve execution of anything on a computer,
    except perhaps a Correctness Verification Aid package. */
  • Ya puestos...

    (Puntos:1)
    por Mariachy (15390) el Martes, 23 Noviembre de 2004, 18:15h (#392995)
    ( Última bitácora: Miércoles, 15 Marzo de 2006, 18:22h )
    Otra cosa muy curiosa es el nombre que se dan a las variables/funciones... recuerdo hace un tiempo q explorando el código fuente de Tux Racer me pasé una tarda entera riéndome...

    ...y es que ya lo decía Jack el Destripador... 'la belleza está en el interior'
  • Yo no pongo comentarios

    (Puntos:2, Divertido)
    por jmga (13737) el Martes, 23 Noviembre de 2004, 19:30h (#393041)
    ( Última bitácora: Jueves, 04 Noviembre de 2004, 14:28h )

    Yo no pongo comentarios para optimizar el codigo, ya que un programa con comentarios tarda más al compilarse, ocupa más el fichero compilado y ademas es más lento.

    Por si fuera poco, también utilizo utilizo nombres cortos para las variables, del tipo "a1","a2"... para optimizar el código al máximo. :P

  • Cada tonto con su tema...

    (Puntos:1, Informativo)
    por pobrecito hablador el Martes, 23 Noviembre de 2004, 20:21h (#393062)
    y cada lenguaje con su estilo de comentarios:

    VisualBasic: "REM" y "'"
    C++: "//" y "/* */"
    PHP: "#"
    Delphi: "//"
    Pascal: "{ }"
    En un .conf: "%"
    En el pseudolenguaje visto en (mi) clase: "(* *)"

    Y ¿alguien sigue?
  • Cada dia mas y mas.

    (Puntos:1)
    por Tei (4535) el Martes, 23 Noviembre de 2004, 21:44h (#393142)
    ( http://barrapunto.com/ | Última bitácora: Jueves, 09 Diciembre de 2010, 21:59h )
    Con programas pequeños no hace falta aunque apetece. Pero con programas grandes se va haciendo mas y mas necesario.
    Ahora mismo estoy modificando un phpnuke y me dan ataques de llorera de lo poco o nada comentado que esta y de cierta mezcla de tamaños de tabulador que hay en mi codigo.
    ¿Alguien conoce un enbellecedor de codigo para php buenecillo?.

    Con C escribo cosas como //TODO //HACK y //INFO, en php simplemente me explayo.
  • por Tei (4535) el Martes, 23 Noviembre de 2004, 21:56h (#393151)
    ( http://barrapunto.com/ | Última bitácora: Jueves, 09 Diciembre de 2010, 21:59h )
    Despues que has frotado el monitor con un iman, sale la palatalla distorsionada, y por tienen los monitores un boton especial que da un petardazo y se arreglan ese desbarajuste.

    Yo creo que los programadores deberiamos tener algo igual. No se vosotros pero a mi me ocurre que cuando algo no me sale, de eso que se te come una hora entera o mas intentandolo, al dia siguiente sale en los primeros 4 minutos ?:D
  • por giordino (2090) el Martes, 23 Noviembre de 2004, 22:18h (#393174)
    ( http://giordino.esmiweb.com/ | Última bitácora: Domingo, 24 Junio de 2007, 08:08h )
    Y mi opción ha sido la del "making of..." Si seré friki.... ;)
  • por MelomanoArrepentido (14586) el Miércoles, 24 Noviembre de 2004, 07:50h (#393328)
    ( Última bitácora: Miércoles, 10 Febrero de 2010, 11:10h )
    Yo si uso comentarios y vienen muy bien para programas gansos, aunque esté todo muy estructurado. Pasa un mes y si no me cuesta saber como hice las cosas.
    Eso si todos los comentarios haciendo su función, nada de chorraditas que nada tienen que ver con el programa.
  • YO NO PROGRAMO

    (Puntos:1)
    por wontolla (6712) el Miércoles, 24 Noviembre de 2004, 08:09h (#393338)
    Los que somos de sistemas no hacemos eso, metemos las 4 líneas que necesitamos para hacernos los comandos y los llevamos en un CD de empresa en empresa, comentarios pa qué
  • por sto (5415) el Miércoles, 24 Noviembre de 2004, 08:56h (#393371)
    En principio creo que los comentarios sí son necesarios, pero yo intento aprovecharlos para documentar el código.

    En Python uso docstrings que pueden usarse con pydoc, en C y C++ no he llegado a usar cweb, pero si he trabajado con DOC++ (de hecho durante una época también lo usé con Java además del JavaDoc).

    Para el que esté interesado hay una lista de herramientas útiles para hacer literate programming en http://www.literateprogramming.com/ftools.html [literateprogramming.com]

  • Doxygen?

    (Puntos:1)
    por KraMMeR (9571) <reversethis-{moc.liamg} {ta} {otnuple}> el Miércoles, 24 Noviembre de 2004, 09:06h (#393377)
    A mi en la carrera me enseñan a usar doxygen... ¿no lo usa nadie?
    • Re:Doxygen? de reidrac (Puntos:2) Miércoles, 24 Noviembre de 2004, 10:08h
  • por Edgtho (11022) el Miércoles, 24 Noviembre de 2004, 09:47h (#393392)
    ( http://www.clubvenox.es/ | Última bitácora: Lunes, 10 Octubre de 2005, 13:20h )
    Ni ironias ni leches, los comentarios en el codigo es algo absolutamente imprescindible. Por muy simple que sea un programa. No soy el unico que se ha tenido que enfrentar a unas cuantas miles de lineas sin un solo comentario y a las que el mismo programador original no tenia ni idea de para que funciana.

    Si juntas "programador pesimo" mas "codigo desastroso" mas "no pongo ni un solo comentario", terminas teniendo una combinacion explosiva brutal que en el momento de explotar salpica de mierda a todo quisqui.

    No quisiera señalar a una antigua empresa mia pero alli me conocian como "el señor de los marrones" porque siempre me tocaba perder el tiempo por culpa de otros. Era increible ver como te tocaba perder semanas por un codigo mal programado y sin un puto comentario.

    ¿Solucion? Pues no dejar los comentarios para el final y si se tiene que esperar una semana que se espere. Es mejor esperar una semana y que todo vaya bien y que ante cualquier fallo cualquier otro programador pueda arreglarselo de forma rapida y sencilla, que no que todo este hecho mierda y que en tener un fallo esten todos escondiendose.

    --
    Si le das a alguien un programa, lo frustarás un día. Si le enseñas a programar, lo frustarás toda
  • por javispedro (14654) el Miércoles, 24 Noviembre de 2004, 22:33h (#393769)
    Bueno, mis profesores se cabrean un poco cuando ven el quinto "<xml><todo:item finishdate="Tomorrow">Completar historia reciente</todo:item></xml>" que me he olvidado de quitar en los informes...
    No todo han de ser programadores "de", tambien se pueden poner comentarios en OO Writer; sino, ¿por qué iban a poner la sección de "Notas" en los manuales de videojuegos privativos?
  • por DanielSan (10124) el Lunes, 29 Noviembre de 2004, 12:14h (#396294)
    ( http://guslibu.awardspace.com/ | Última bitácora: Jueves, 08 Julio de 2010, 08:35h )
    De un código sin comentarios se puede saber lo que hace, pero de un código con buenos comentarios se debería poder extraer lo que tiene que hacerse (cuál es o debería ser su función, sin atender al método usado), teniendo la solución propuesta e implementada por el anterior programador delante. Esto hace a los bloques de código susceptibles de ser cambiados, mejorados, reestructurados o eliminados a conveniencia del programador sin incurrir en problemas no previstos.

    Por tanto, no pondrás:
    v += 2;

    ni:
    v += 2; # sumo 2 a la variable w

    sino:
    v += 2; # para acelerar la búsqueda siguiente

    Otra persona podría ver ese código y pensar que si cambia de algoritmo no es necesario sumar nada y la búsqueda no se ralentiza. Si el comentario no existiera, no sabría el papel que tiene la operación dentro del conjunto y tendría que averiguarlo primero si quiere poder verificar o modificar el código.

    ____Lameness filter encountered._____
    Tu comentario ha violado el filtro de compresión "postercomment". Prueba con menos espacios en blanco y/o menos repeticiones . Comentario detenido.
    //Problemas con el copy&paste del GVIM al Firefox//
  • por pizte (16834) el Lunes, 29 Noviembre de 2004, 23:37h (#396852)
    Yo opino que las cosas si estan bien hechas es como mejor van a repercutir, imaginate un programa de mil lineas en Perl sin comentar, te moririas par intentar descifrarlo. Yo siempre comento los programas, por pequeños que sean, les pongo cabeceras, comentarios en cada seccion lo mas explicativos y breves posibles. Asi despues de unos meses si tengo que retocarlo me entero de como iba el programa. Obviamente si estas trabajando en un cargo de bastate responsabilidad y te piden el codigo para ayer... deben hacerse comentarios igual, pero en ese caso deberian ser los mas escuetos posibles y solo en sitios que se vean oportunos, tan solo para dar una idea, ya que tardarias un poco mas en hacer el codigo, pero a la hora de retocarlo se te facilitaria la tarea. Un saludo. -- You know you're using the computer too much when your life becomes routine enough to write a script to do it for you.
  • por DanielSan (10124) el Lunes, 29 Noviembre de 2004, 11:57h (#396282)
    ( http://guslibu.awardspace.com/ | Última bitácora: Jueves, 08 Julio de 2010, 08:35h )
    Creo que eso es una interpretación tuya, la programación extrema promueve que la comunicación entre los dearrolladores se haga a través de código, pero esto no significa que no pueda haber comentarios en ese código. Especialmente en las partes que deban señalarse como posibles objetivos para recodificar.
    [ Padre ]
  • por DanielSan (10124) el Lunes, 29 Noviembre de 2004, 12:35h (#396313)
    ( http://guslibu.awardspace.com/ | Última bitácora: Jueves, 08 Julio de 2010, 08:35h )
    Aborrezco los i, j en los bucles: mejor iCol, iFila, iNum, etc.

    Cuando se usa i, j (o si quieres f, c) el código queda mucho más compacto y fácil de verificar de un vistazo. Si no vas a hacer un uso extraño de i y j (por ejemplo array[i*j-4][j+2], entonces un array[i][j] es mucho más cómodo y fácil de leer que un arrayDoble[iFila][iCol]). Y nada dice que tengas siempre que seguir el mismo criterio para nombrar variables en todos los casos: No hay técnicas mejores para todo, hay técnicas mejores para "esto" y peores para lo "otro".

    3. Borrar los comentarios que queden superfluos después de haber intentado que el código sea autoexplicativo.
    4. Añadir comentarios allí donde, al día siguiente, la cosa no sea completamente obvia para mí.


    Me gusta eso. Yo lo llamaría, saber aprovechar los errores para mejorar o aprendizaje continuo.

    7. En el raro caso de que quiera que alguien no lo entienda, lo ofusco o lo bestia.

    Yo para eso uso programas que ofusquen el código, incluso alguno hecho por mí. así puedes modificar el original y volver a ofuscar siempre que quieras.

    Aunque en realidad, a pesar de todos los esfuerzos por programar con claridad, en cuanto el programa es complejo a las dos semanas no lo entiende ni su padre/madre.

    Esto es que aún no programas todo lo bien que debieras. Si tuvieras que hacer modificaciones al programa MUY a menudo, y tuvieras MUCHOS programas hechos por ti que mantener, al final terminarías por elegir un método sostenible o perecer.

    Normalmente esto sucede por no partir el código en cachitos lo suficientemente pequeños como para ser comprensibles de un vistazo. A menudo se tiende a mezclar la máxima funcionalidad en un sólo bloque código, lo que rompe la reutilización y hace que mantenerlo sea infernal. Si cada porción de código hace una cosa y sólo una, puede probarse por separado, reutilizarse o derivarse fácilmente.

    ¿Por qué todos son "pobrecito hablador"? Es como si hablase con un muerto
    [ Padre ]
  • 4 respuestas por debajo de tu umbral de lectura actual.