Cita:El programa no tiene que hacer comentarios buenos, tiene que hacer comentarios que parezcan comentarios buenos si alguien no se pone a leerlos.
O sea, queres hacer un soft tirahumo basicamente, no?
Cita:los comentarios muchas veces se resuelven con una buena programación. si el código está bien escrito, y es declarativo, los comentarios sobran.
+1. Nosotros no comentamos casi nada, y sin embargo entendemos casi todo el código ("el codigo es de todos"). Si sos expresivo, entonces los comentarios quedarán nomás para explicar algo muy complejo o anti-intuitivo.
Con mas razon es util el software este para jefes rompepelotas.
Sisi, tira humo 100%
resharper hace algo asi... te pone lo que hacen los metodos en base al nombre... si le pones un nombre descriptivo, anda bastante bien
- Off-topic:
- sorry que diga ésto, pero... usen smalltalk!!!
esteMetodoSuma: unNumero con: otroNumero
^unNumero + otroNumero
y no necesitan comentar nada, solamente programar bien.
(15-01-2013 15:35)brunodiaz escribió: [ -> ]Me parece que no leiste el thread.
El programa no tiene que hacer comentarios buenos, tiene que hacer comentarios que parezcan comentarios buenos si alguien no se pone a leerlos.
Es exactamente tener codigo, verlo en el inodoro y decir "Eso es mierda" o "Luego voy a tirar la cadena"
mmmm... en ese caso, no le veo la utilidad real. más que para aprender, o boludear.
perdón, no es por tirarlo abajo, pero pensé que la idea era hacer algo como para vender y que se pueda aplicar en cualqueir laburo.
Cita:+1. Nosotros no comentamos casi nada, y sin embargo entendemos casi todo el código ("el codigo es de todos"). Si sos expresivo, entonces los comentarios quedarán nomás para explicar algo muy complejo o anti-intuitivo.
acá trabajamos también así
El programa no busca para nada mejorar el codigo, sino pasar rapidamente validaciones pelotudas de gente molesta
(16-01-2013 17:31)LeaTex escribió: [ -> ]sorry que diga ésto, pero... usen smalltalk!!!
Aca estamos hablando de lenguajes con salida laboral. Smalltalk y su VM debe tener menos mercado fortran
Ah la idea es convertir algo como esto...
public class PibeCantina : Cumbia
{
public void executePibeCantina(bool parametroBooleanoAlPedo)
{
// Prints the complete lyrics to "Pibe Cantina" and "99 Bottles of Beer".
}
}
...en algo como esto?
/// <summary>
/// This class implements PibeCantina. This Class inherits from Cumbia.
/// <summary>
public class PibeCantina : Cumbia
{
/// <summary>
/// execute PibeCantina
/// </summary>
/// <param name="parametroBooleanoAlPedo">A value indicating wether <x> or <y></param>
public void executePibeCantina(bool parametroBooleanoAlPedo)
{
// Prints the complete lyrics to "Pibe Cantina" and "99 Bottles of Beer".
}
}
Claro, pero no en ingles y con frases random que parezcan mas hechas por humanos
Perdón, pero me sumo a la tirada abajo.
Los comentarios en general se aplican cuando el código en sí, no explica claramente lo que hace la función.
Si la idea es hacer algo así:
/**
* Devuelve el nombre y el apellido de un User
* @param User $user
* @return string
*/
public function getNameAndLastname(User $user){
return $user->getName() . ' ' . $user->getLastname();
}
PONELE que podés llegar a hacer algo así, el comentario de explicación me parece absolutamente al pedo, ergo me parece más al pedo aún hacer algo que escriba cosas al pedo.
Además, si es algo complejo de explicar, que es cuando necesitás verdaderamente el comentario, el mega algoritmo no va a saber hacer nada que valga la pena.
Abrazo de gol.
(31-10-2013 00:43)gonnza escribió: [ -> ] (15-01-2013 13:54)brunodiaz escribió: [ -> ]Esto no es una discusion de si es necesario o no comentar el codigo, si hay que hacer metodico y hacerlo mientras se programa ni nada de eso. Es para que los que nos rompe las pelotas ver que de repente nos mandamos 20 clases sin comnetarios porque somos unos nabos tengamos algo para mentir y decir que comentamos.
Si el problema a resolver es que tu jefe, o lo que sea, te putea porque no agregaste el comentario sobre la clase 'Perro' indicando que es una clase para Perros que hereda de 'Caninos', hay un problema con ese tipo.
Yo me esforzaría más por explicarle a esa persona que lo que me está pidiendo está mal, a que hacer un proyecto "Comentador de código para zafar". Lo veo más productivo.
Quizás no estoy entendiendo la defensa, perdón
.
Ah, creo que entendí, retracto lo último.
De todas formas estoy en desacuerdo
.
Creo que la idea era hacer una joda para reirse un rato, no algo serio para utilizar...
Mala mía entonces, leí [Proyecto] y me puse los lentes.