SoloCodigo

Asuntos Oficiales => La taberna del BIT => Mensaje iniciado por: su - en Jueves 19 de Abril de 2007, 02:32

Título: Ustedes Comantan Sus Codigos?
Publicado por: su - en Jueves 19 de Abril de 2007, 02:32
Buno yo a veces lo hago y estimaria que menos del 5% a no ser de que sea algo grande.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Bicholey en Jueves 19 de Abril de 2007, 04:17
:lol:  :lol:


Siempre que empieza a aprender algo nuevo lo comento pero ya una vez entendido lo dejo sin comentarios
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Mollense en Jueves 19 de Abril de 2007, 05:56
Generalmente si.-
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Eternal Idol en Jueves 19 de Abril de 2007, 08:12
Solo cuando uso un "hack", una tecnica que no es la mas logica o para poner advertencias.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: JuanK en Jueves 19 de Abril de 2007, 14:27
Todo lo necesario, es decir:

clases, métodos, estructuras, enumeraciones, constantes, atributos de clase etc.

dentro de los métodos solo comento lo necesario cuando codifico cosas que se presume no serán entendibles de manera directa, es decir es ridículo tener algo como:

//Aca se asigna 1 a la variable a...
Código: Text
  1. int a = 1;
  2.  

Sin embargo no es nada ridículo comentar algo como esto:
Código: Text
  1. tmp[x][y] = (byte)(~((int)bmpMatrix[y][x]));
  2.  

Siempre comento el código pensando en que más adelante son otros los que lo necesitaran  trabajar, o al menos eso trato.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: RadicalEd en Jueves 19 de Abril de 2007, 14:55
Algunas veces cuando el trabajo no es para mi.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: JuanK en Jueves 19 de Abril de 2007, 15:09
La cantidad de comentarios en el código es un indicador importante de la calidad del código que se produce.

El Número de líneas de código por módulo, líneas de comentarios por número total de lineas del modulo hacen parte de una métrica de legibilidad.

Existen herramientas como CODECOUNT que facilitan en algo la medición de las métricas.

Adicionalmente los procesos de inspección de software, dentro de un ciclo de desarrollo de software controlado, tal como los descritos por metodologías de calidad como CMMI, implican la inclusión de actividades de revisiones de pares, donde la inspección de código es una de esas revisiones y allí es necesario verificar  (entre otras tantas cosas) la cantidad y calidad de los comentarios a cualquier pieza de software o modificación de pieza de software generada e inspeccionada, en estos casos cuando la inspección detecte que no se cumple con suficiencia los parámetros de calidad, la pieza de software es rechazada y devuelta al programador hasta que esta cumpla con los parámetros especificados.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Eternal Idol en Jueves 19 de Abril de 2007, 15:23
Como todos deben saber los comentarios no se compilan.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: JuanK en Jueves 19 de Abril de 2007, 15:49
Si es cierto, y desde el punto de vista de programador que no guste de comentar el código eso es una justificación valida, pero no desde el punto de vista de un arquitecto de software, un ingeniero de sistemas  o de un líder técnico.

El software no es un solo el programa ('código compilado'), a Dios Gracias.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Eternal Idol en Jueves 19 de Abril de 2007, 15:52
Cita de: "JuanK"
Si es cierto, y desde el punto de vista de programador que no guste de comentar el código eso es una justificación valida, pero no desde el punto de vista de un arquitecto de software, un ingeniero de sistemas  o de un líder técnico.

El software no es un solo el programa ('código compilado'), a Dios Gracias.
Eso no es una justificacion sino un hecho, ya cada uno entrara en sus valoraciones subjetivas pero eso es un hecho.

Para mi los comentarios tienen que estar para ayudar a entender un codigo de una determinada complejidad y se le presupone al programador un entendimiento basico para estar frente al codigo, no es para que aprenda a programar. Para eso estan los tutoriales y no el software.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: lencho en Jueves 19 de Abril de 2007, 16:39
Cita de: "Bicholey"
:lol:  :lol:


Siempre que empieza a aprender algo nuevo lo comento pero ya una vez entendido lo dejo sin comentarios
estoy completamente de acuerdo con Bicholey, cuando hago algo nuevo lo comento bien explicado, y a veces pa los demas algo ya comunes, solo en el comienzo del metodo.


BYTE.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Bicholey en Jueves 19 de Abril de 2007, 16:39
Cita de: "Eternal Idol"
Para mi los comentarios tienen que estar para ayudar a entender un codigo de una determinada complejidad y se le presupone al programador un entendimiento basico para estar frente al codigo, no es para que aprenda a programar. Para eso estan los tutoriales y no el software.
 :lol:  :lol:  :lol:  :lol:


Totalmente de acuerdo...
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: ElNapster en Jueves 19 de Abril de 2007, 16:40
Solo las cosas mas importartantes o procedimientos muy astrales jajaja  :P
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: JuanK en Jueves 19 de Abril de 2007, 17:01
Cita de: "Eternal Idol"
Eso no es una justificacion sino un hecho, ya cada uno entrara en sus valoraciones subjetivas pero eso es un hecho.

Para mi los comentarios tienen que estar para ayudar a entender un codigo de una determinada complejidad y se le presupone al programador un entendimiento basico para estar frente al codigo,
El problema es presuponer porque uno no sabe quien le metera la manos al software el dia de mañana.

Citar
no es para que aprenda a programar. Para eso estan los tutoriales y no el software.

Y este es otro grave error, quien dijo que se debe comentar el codigo para aprender a programar?

el código se comenta es para ser util dentro el contexto del producto, si uno esta haciendo un sw y hace  alguna asignación sencilla como ej:

Citar
rparams.Add(something);
intnRepreParams = 50;

desde tu punto de vista no se debe comentar porque no estas enseñando a programar, pero lo cierto es que es probable que se deba comentar porque dentro del producto esto hace algo importante:
Citar
//Asignar la cantidad de parámetros representativos para el calculo de rezagos lo
//que sea...
//Este valor se tiene en cuenta en los procesos diurnos de...
intNumParams = 50;

Lo que si es un hecho es que la calidad del código va en detrimento sino se encuentra bien comentado, incluso a uno mismo unos años después se le puede complicar revisar una pieza de código que hizo tiempo atrás, entonces como no lo sera para otra persona que nunca habia visto ese código. Esos son hechos.

Por otro lado entonces según tu afirmación todas las convenciones de calidad de software estarían equivocadas y tu no... :whistling:
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Eternal Idol en Jueves 19 de Abril de 2007, 18:07
Cita de: "JuanK"
El problema es presuponer porque uno no sabe quien le metera la manos al software el dia de mañana.

No es ningun problema, sera el problema de una persona NO CAPACITADA para manejar el codigo que le asignaron.

Cita de: "JuanK"
el código se comenta es para ser util dentro el contexto del producto

¿Quien dijo lo contrario?

Cita de: "JuanK"
si uno esta haciendo un sw y hace  alguna asignación sencilla como ej:

Código: Text
  1. rparams.Add(something);
  2. intnRepreParams = 50;
  3.  

No estoy de acuerdo, grave error es usar un valor directamente en vez de darle un simbolo util.

Cita de: "JuanK"
desde tu punto de vista no se debe comentar porque no estas enseñando a programar

No, eso lo dijiste vos y no yo.

Cita de: "JuanK"
Lo que si es un hecho es que la calidad del código va en detrimento sino se encuentra bien comentado, incluso a uno mismo unos años después se le puede complicar revisar una pieza de código que hizo tiempo atrás, entonces como no lo sera para otra persona que nunca habia visto ese código.

Seguro, si lo programas asi como mostras no me cabe duda.

Cita de: "JuanK"
Por otro lado entonces según tu afirmación todas las convenciones de calidad de software estarían equivocadas y tu no...

Te agradeceria que dejaras de sacar conclusiones sobre mis afirmaciones ya que es evidente que las interpretas de una manera diferente a mi intencion.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: JuanK en Jueves 19 de Abril de 2007, 18:26
Cita de: "Eternal Idol"
1
No es ningun problema, sera el problema de una persona NO CAPACITADA para manejar el codigo que le asignaron.
-------------
2
No estoy de acuerdo, grave error es usar un valor directamente en vez de darle un símbolo util.

-------------
3
No, eso lo dijiste vos y no yo.

-------------
4
Cita de: "JuanK"
Lo que si es un hecho es que la calidad del código va en detrimento sino se encuentra bien comentado, incluso a uno mismo unos años después se le puede complicar revisar una pieza de código que hizo tiempo atrás, entonces como no lo sera para otra persona que nunca habia visto ese código.

Seguro, si lo programas asi como mostras no me cabe duda.
-------------
5
Cita de: "JuanK"
Por otro lado entonces según tu afirmación todas las convenciones de calidad de software estarían equivocadas y tu no...

Te agradeceria que dejaras de sacar conclusiones sobre mis afirmaciones ya que es evidente que las interpretas de una manera diferente a mi intencion.
-------------
1
ahi hay un problema de calidad, pues no estas entregando un buen producto de sw por suponer cosas, generalmente alguien puede ser buen programador pero no saber nada del producto como sucede con la mayoria de personas nuevas en una empresa.

2
Es un ejemplo

3
NO,NO LO DIJE YO, pero tu lo insinuaste como si alguien lo hubiera dicho

Cita de: "Eternal Idol"
Para mi los comentarios tienen que estar para ayudar a entender un codigo de una determinada complejidad y se le presupone al programador un entendimiento basico para estar frente al codigo, no es para que aprenda a programar. Para eso estan los tutoriales y no el software.

4
Es un ejemplo...

5
Es un foro de opinión y eso es lo que se entiende de las afirmaciones.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Eternal Idol en Jueves 19 de Abril de 2007, 18:35
Si, profesor Juank, todo lo que usted diga seguro que es asi, incluso sabe lo que intentamos decir o pensamos los demas. Un aplauso! :rolleyes:
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Bicholey en Jueves 19 de Abril de 2007, 18:52
Cita de: "Eternal Idol"
Si, profesor Juank, todo lo que usted diga seguro que es asi, incluso sabe lo que intentamos decir o pensamos los demas. Un aplauso! :rolleyes:
 :P  :P  :P

Por cierto que Juank no es profesor en alguna facultad alla en colombia ???
me parece haberlo leido por ahi...
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: RadicalEd en Jueves 19 de Abril de 2007, 19:00
No
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Mollense en Jueves 19 de Abril de 2007, 19:01
Cita de: "JuanK"
Cita de: "Eternal Idol"
Eso no es una justificacion sino un hecho, ya cada uno entrara en sus valoraciones subjetivas pero eso es un hecho.

Para mi los comentarios tienen que estar para ayudar a entender un codigo de una determinada complejidad y se le presupone al programador un entendimiento basico para estar frente al codigo,
El problema es presuponer porque uno no sabe quien le metera la manos al software el dia de mañana.

Citar
no es para que aprenda a programar. Para eso estan los tutoriales y no el software.

Y este es otro grave error, quien dijo que se debe comentar el codigo para aprender a programar?

el código se comenta es para ser util dentro el contexto del producto, si uno esta haciendo un sw y hace  alguna asignación sencilla como ej:

Citar
rparams.Add(something);
intnRepreParams = 50;

desde tu punto de vista no se debe comentar porque no estas enseñando a programar, pero lo cierto es que es probable que se deba comentar porque dentro del producto esto hace algo importante:
Citar
//Asignar la cantidad de parámetros representativos para el calculo de rezagos lo
//que sea...
//Este valor se tiene en cuenta en los procesos diurnos de...
intNumParams = 50;

Lo que si es un hecho es que la calidad del código va en detrimento sino se encuentra bien comentado, incluso a uno mismo unos años después se le puede complicar revisar una pieza de código que hizo tiempo atrás, entonces como no lo sera para otra persona que nunca habia visto ese código. Esos son hechos.

Por otro lado entonces según tu afirmación todas las convenciones de calidad de software estarían equivocadas y tu no... :whistling:
Estoy de acuerdo contigo.-

En un trabajo profesional no deberían mezquinarse los comentarios por muchos motivos, siendo los más importantes (A mi modo de ver) la comunicación entre miembros del proyecto y el costo de mantenimiento.-

 :comp:
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: JuanK en Jueves 19 de Abril de 2007, 19:11
Cita de: "Bicholey"
Cita de: "Eternal Idol"
Si, profesor Juank, todo lo que usted diga seguro que es asi, incluso sabe lo que intentamos decir o pensamos los demas. Un aplauso! :rolleyes:
:P  :P  :P

Por cierto que Juank no es profesor en alguna facultad alla en colombia ???
me parece haberlo leido por ahi...
Fui profesor un tiempo, pero lo hice un poco por experimentar, aca eso es muy mal pago por lo menos en el nivel que me tocaba pues aun no tengo maestria, por otro lado enseñar resulta decepcionante cuando la gente solo quiere pasar las materias y no les interesa realmente el conocimiento ni la preparación para generar conocimiento.

Es decir la gente cree que la clase debe ser aprender a usar un lenguaje pero no entiende que la clase debe ser aprender a estructurar las ideas para poder usar un lenguaje ( herramienta) cualquiera sin restricción alguna. Tampoco es facil que la gente entienda que no va a la universidad a aprender a programar ni a ser el mejor programador del mundo, a la universidad se va a formarse 'universalmente' para adquirir destrezas en la creacion de nuevo conocimiento y en la formulación y creación de proyectos/productos de software o de tecnología de calidad.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: JuanK en Jueves 19 de Abril de 2007, 19:13
Cita de: "Angel_K_ido"


En un trabajo profesional no deberían mezquinarse los comentarios por muchos motivos, siendo los más importantes (A mi modo de ver) la comunicación entre miembros del proyecto y el costo de mantenimiento.-

 :comp:
por supuesto asi es.
el costo de mantener ese tipo de esquemas se ve amortizado y justificado con el paso del tiempo, es una inversión de dinero y de calidad a largo plazo.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: su - en Jueves 19 de Abril de 2007, 21:59
Cita de: "JuanK"
Cita de: "Bicholey"
Cita de: "Eternal Idol"
Si, profesor Juank, todo lo que usted diga seguro que es asi, incluso sabe lo que intentamos decir o pensamos los demas. Un aplauso! :rolleyes:
:P  :P  :P

Por cierto que Juank no es profesor en alguna facultad alla en colombia ???
me parece haberlo leido por ahi...
Fui profesor un tiempo, pero lo hice un poco por experimentar, aca eso es muy mal pago por lo menos en el nivel que me tocaba pues aun no tengo maestria, por otro lado enseñar resulta decepcionante cuando la gente solo quiere pasar las materias y no les interesa realmente el conocimiento ni la preparación para generar conocimiento.

Es decir la gente cree que la clase debe ser aprender a usar un lenguaje pero no entiende que la clase debe ser aprender a estructurar las ideas para poder usar un lenguaje ( herramienta) cualquiera sin restricción alguna. Tampoco es facil que la gente entienda que no va a la universidad a aprender a programar ni a ser el mejor programador del mundo, a la universidad se va a formarse 'universalmente' para adquirir destrezas en la creacion de nuevo conocimiento y en la formulación y creación de proyectos/productos de software o de tecnología de calidad.
Lo ironico es si vemos las relaciones de tiempo-trabajo un profesor gana buen dinero...

Bien. retomando... yo creo que los comentarios es por utilidad propia a la hora de documentar el software y su documento es para los programadores posteriores.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: JuanK en Jueves 19 de Abril de 2007, 22:12
Cita de: "su -"
Lo ironico es si vemos las relaciones de tiempo-trabajo un profesor gana buen dinero...
 
bueno, aca no mucho, pero sobre todo el problema es que yo no era un profesor con la formacion necesaria para devengar bien.


Citar
Bien. retomando... yo creo que los comentarios es por utilidad propia a la hora de documentar el software y su documento es para los programadores posteriores.

Creo que ambos son para el que desarrolla y para el que desarrollara.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Enko en Jueves 19 de Abril de 2007, 22:55
Citar
Lo ironico es si vemos las relaciones de tiempo-trabajo un profesor gana buen dinero...

bueno, aca no mucho, pero sobre todo el problema es que yo no era un profesor con la formacion necesaria para devengar bien.
En Argentina, siendo profesor de 9 hs semanales te aseguras un sueldo mediocre y una obra social.
Muchos de mis profesores de facultad de Derecho son abogados y dan pocas horas semanales solo para tener la obra social.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Epa en Jueves 19 de Abril de 2007, 23:30
xD

El pleito se lleva el tema por las ramas..

En mi caso comento donde se que me va a ahorrar tiempo al leerlo. O donde es muy engorroso.

Y en el caso de que lea un codigo que no esta hecho por mi, intento leer la mayor cantidad de codigo posible, y no fiarme tanto de los comentarios, aunque no digo q no sean utiles.

Bueno , ahi mi opinion, saludos :hola:

PD: y basta de peleas q no ayudan a nadie  :P
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: SteelX en Viernes 20 de Abril de 2007, 05:17
Me toca. por politica de la empresa lo aprendi como William Wallace. Wallace buenas o Wallace malas
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: SteelX en Viernes 20 de Abril de 2007, 05:20
Uppsss me equivoque.. no sabia que habian cambiado de tema :lol:  :lol:
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Angel38 en Viernes 20 de Abril de 2007, 06:13
La verdad solo comento lo que no entiendo, es decir que todo la aplicación tiene mas comentarios que codigo. :(
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Blag en Sábado 21 de Abril de 2007, 14:49
Bueno....como leí alguna vez....

Citar
Si fué dificil hacerlo....Que sea más dificil leerlo

Por eso nunca comento mis códigos  :lol:

P.D: Solo comento un poco los de Código Latino, pero esa es otra historia  :comp:

Saludos,

Blag  :smartass:
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Mollense en Sábado 21 de Abril de 2007, 16:48
Cita de: "Blag"
Bueno....como leí alguna vez....

Citar
Si fué dificil hacerlo....Que sea más dificil leerlo

Por eso nunca comento mis códigos  :lol:

P.D: Solo comento un poco los de Código Latino, pero esa es otra historia  :comp:

Saludos,

Blag  :smartass:
Hay hay hay, un fantasma  :o

No te desaparezcas Blag !! :beer:
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Blag en Sábado 21 de Abril de 2007, 19:27
Citar
Hay hay hay, un fantasma  :o

No te desaparezcas Blag !!  :beer:

No te preocupes que ya regresé  :lol:

Saludos,

Blag  :devil:
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: F_Tanori en Sábado 21 de Abril de 2007, 23:02
No se puede votar sin opinar  <_<


*Depende, si es algo complicado de entender a otra persona cuando se requiera modificar (o para mi mismo  :P para recordar) y para saber donde, cuando, y que es lo que modifique yo cuando son sistemas donde intervenimos varios *

Saludos
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: sergiotarrillo en Domingo 22 de Abril de 2007, 14:09
cuando aprendí a programar (en C), comentaba todo, ahora sólo algunas partes, para recordar que tengo que hacer algo más, o tambien por descripción del código, o para códigos pocos entendibles.

En algunos casos, pongo alguna frases mías en los comentarios: "este código esta bravazo", "se puede mejorar", "no lo copies conio", y así....

Saludos,
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Miguel_ACL en Domingo 29 de Abril de 2007, 08:44
Yo comento mis códigos para poderlo utilizar en otros programas.
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: senzao18 en Jueves 3 de Mayo de 2007, 02:54
Obligatorio .- Solo cuando es un proceso muy largo y que puede confundir a quien quiera modificarlo en el futuro.. osea yo....

Y cuando modifico codigo de terceros...


aunque los ultimos programas los comenté todo de todo.. creo que fue por que tenia tiempo  :angry:
Título: Re: Ustedes Comantan Sus Codigos?
Publicado por: Jhois en Jueves 3 de Mayo de 2007, 05:17
Bueno, yo comento solo lo necesario. hay veces que hay mucho codigo que hacer, y pa recordar en lo que me quedo y qué esoty haciendo pues lo comento, nada mas..

Eso es... :P