Resultados de la encuesta.
Nunca. Y además, las variables son todas foo, bar y baz (con números si es pertinente)
| |
8% |
122 votos |
Al principio de cada sección
| |
26% |
380 votos |
Una al principio del fichero con el nombre del fichero y punto
| |
3% |
49 votos |
Uso "literate programming" y escribo poesías en los comentarios
| |
10% |
155 votos |
Comento cada línea, cada variable, y cada comentario
| |
7% |
109 votos |
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?
| |
14% |
207 votos |
¿Mande? ¿Comentarios?
| |
12% |
172 votos |
Al encuestador le voy a comentar yo un par de cosas
| |
15% |
226 votos |
1420 votos en total.
[
Cabina de votación |
>Otras encuestas |
Página principal
]
- No te quejes de la falta de opciones. Las opciones son limitadas al elaborar la encuesta y no se puede complacer a todo el mundo.
- Si te sientes creativo, propón tus propias encuestas. Eso sí, te sugerimos que leas primero las encuestas anteriores.
- Todo este rollo es insensatamente inexacto: hay errores de redondeo, pucherazos, IPs dinámicas, cortafuegos, proxies... Si estás utilizando estas cifras para hacer algo importante, estás totalmente chiflado.
¿Buenos programadores?
(Puntos:3, Informativo)frases
(Puntos:4, Divertido)( http://mesallena.blogspot.com/ | Última bitácora: Domingo, 23 Octubre de 2005, 18:07h )
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...
Offtopic
(Puntos:2)( http://barrapunto.com/ )
Pa que? Pa cagala?
no comment
(Puntos:1)( 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)( http://barrapunto.com/ )
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)( Última bitácora: Viernes, 02 Diciembre de 2005, 13:38h )
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.
¿por donde iba?
(Puntos:1)( http://barrapunto.com/ | Última bitácora: Miércoles, 06 Julio de 2005, 18:44h )
(2p2+k2ya+a2).1/5=kkdkdt
Anecdota
(Puntos:3, Interesante)( 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)( http://www.ionionzoo.tk/ | Última bitácora: Jueves, 26 Mayo de 2005, 15:07h )
Para nada, lo que está claro son 2 cosas:
1. Los buenos programadores sí 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]
Re:Te habrás quedado agusto...
(Puntos:5, Informativo)( http://atalaya.blogalia.com/ | Última bitácora: Miércoles, 04 Febrero de 2009, 17:50h )
Atalaya [blogalia.com]
Comentarios obscenos e inmorales
(Puntos:2, Divertido)( http://barrapunto.com/~spike_mandrake/journal/ | Última bitácora: Jueves, 20 Agosto de 2015, 13:09h )
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.
¡Cáspita! ¡Qué suceso más desafortunado!
Comentarios hay muchos y muy buenos
(Puntos:3, Divertido)( http://www.fluzo.org/ )
"// 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)( http://www.barrapunto.com/ )
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)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
¿Y los "print" para 'debugear'?
(Puntos:1)( Última bitácora: Domingo, 05 Diciembre de 2010, 22:01h )
La pregunta clave
(Puntos:4, Informativo)( http://barrapunto.com/ )
¿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 eso hay veces que queda:
//Y cierro el fichero
fichero.close( ) ;
Pueees...
(Puntos:1, Inspirado)/* 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
All the comments I need
(Puntos:4, Divertido)( http://kamborio.com/ )
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)( Última bitácora: Miércoles, 15 Marzo de 2006, 18:22h )
...y es que ya lo decía Jack el Destripador... 'la belleza está en el interior'
Yo no pongo comentarios
(Puntos:2, Divertido)( Ú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)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)( Última bitácora: Viernes, 03 Febrero de 2012, 15:18h )
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.
Boton de descarga gaussiana.
(Puntos:1)( Última bitácora: Viernes, 03 Febrero de 2012, 15:18h )
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
No soy programador pero he votado igualmente
(Puntos:1)( http://giordino.esmiweb.com/ | Última bitácora: Domingo, 24 Junio de 2007, 08:08h )
Giordino: Maruja linuxera nº 2090 [barrapunto.com]
Comentarios: sólo donde haga falta
(Puntos:1)( Última bitácora: Miércoles, 10 Febrero de 2010, 11:10h )
Eso si todos los comentarios haciendo su función, nada de chorraditas que nada tienen que ver con el programa.
Antes de votar consulta el m [15m.cc]
YO NO PROGRAMO
(Puntos:1)Comentarios y literate programming
(Puntos:1)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)Son completamente necesarios
(Puntos:2)( http://www.clubvenox.es/ | Última bitácora: Lunes, 10 Octubre de 2005, 13:20h )
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
¿Y comentarios en otras partes?
(Puntos:1)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?
Comento lo que se supone que debeRÍA hacer
(Puntos:2)( http://guslibu.awardspace.com/ | Última bitácora: Viernes, 18 Marzo de 2011, 08:29h )
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//
Sin comentarios, se va todo al traste
(Puntos:1)Re:eXtreme Programing
(Puntos:2)( http://guslibu.awardspace.com/ | Última bitácora: Viernes, 18 Marzo de 2011, 08:29h )
Re:en beneficio propio...
(Puntos:2)( http://guslibu.awardspace.com/ | Última bitácora: Viernes, 18 Marzo de 2011, 08:29h )
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