miércoles, 3 de junio de 2009

No hay peor comentario que el comentario que está equivocado

¿Qué tiene mal este código?
for each // Me fijo cantidad de la entrada
where MstId = &MstId2
    if MstTpo = 'R'
        &MstCntR = MstCnt
    else
        &MstCntS = MstCnt
    endif
endfor
Para el que lo ve así, a simple vista, no tiene nada mal. Los que leyeron el título de la nota pueden tener alguna pista.

¡Lo que está mal es el comentario! Porque &MstId2 no es una ENTRADA, es una SALIDA. Claro que el que no conoce el contexto no tiene forma de saberlo, y ahí está el peligro.

Yo estoy a favor de poner comentarios que expliquen lo que hace el programa, pero los comentarios tienen que estar bien, si no, es peor tener comentarios que no tenerlos.

Porque alguien podría leer el for each y quedarse con la idea que toma la cantidad de la entrada, cuando en realidad se queda con la de la salida.

En conclusión, más vale no tener comentarios que tener comentarios equivocados...

3 comentarios:

  1. Este comentario ha sido eliminado por el autor.

    ResponderEliminar
  2. Te lo simplifico, más vale no tener PROGRAMADORES que hacen malos comentarios, que tenerlos.

    Solución final:
    Encontrar al reverendo que hizo el comentario y agregarlo a la bolsa de trabajo de artech ;)

    Saludos
    ElAndrew
    kualquiercosario.blogspot.com

    ResponderEliminar
  3. Andrés: No es tan fácil... En realidad habría que encontrar el que cambió el programa y no cambió el comentario.

    ResponderEliminar