20150327

Comentarios o La simpleza de un buen diseño






Hablando de Programación...


La mayoría de las ocasiones estamos tan enfrascados en algún proyecto, que olvidamos por completo de hacer comentarios en el código. y terminamos haciendo popó por todos lados y no sabemos: cuál? porqué? en qué momento? a qué se debió esa popó?

Por eso es importante etiquetar la popó.

La Popó debe ser clasificada y ordenada, ya que nos podemos perder entre tanta popó, hay tanta popó que podemos pisarla y hacer un batidero de tamaño exponencial.

Pero hay quienes gozan batirse entre la popó, les encanta, hasta se la comen. Y dejan la popó tirada y olvidada, cuando se acuerdan o necesitan de la popó, descubren que no es lo mismo que cuando estaba fresca.

Desean volver a batirse, pero no es lo mismo, siempre hacen la siguiente afirmación: ¡que cagadero hice!

Después de un tiempo hacen el festín, y vuelven a no clasificar la popó, y otra vez se cicla.

Algunos tienen la buena voluntad de hacer el intento de etiquetar su popó y clasificarla, pero no se esfuerzan por hacer los comentarios lo mas explicito posible: ejemplo

add ax,10 ; Suma AX, 10

No aclara nada, deja en lo mismo, no sabemos para que era esa suma.

Pero el problema no esta en etiquetar, sino en ser lo más claro posible en los comentarios. Y un buen diseño siempre ayuda hacer comentarios que realmente nos oriente entre tanta bazofia.




Un buen diseño requiere Diagramas de Flujo

Un diagrama de flujo es una gran ayuda para un programador, vemos como fluye nuestras ideas plasmadas a través de cuadros y flechas, verdadero o falso, acciones o desilusiones.


Pero el dilema que nos topamos es que no podemos usarlos en códigos de programación, porque el código de programación es texto puro. (no gráficas)

Hasta que los artistas llegaron al Cybermundo....


¡BUMMM! ASCII ART ... la salvación del Caganeitor.


Los artistas le sacaron el potencial del código ascii, su limitante no fue obstáculo para al artista, sino una oportunidad para desarrollar belleza. Nos sacudió a los programadores, como con tan poco lograron monumentos.

En estos últimos 3 días, se me ocurrió hacer una caca monumental. Y aquí os dejo. 




El Editor de Comentarios.

Después de ver varios editores estilo ASCII ARTS, me atreví hacer uno propio, ya que la mayoría tenia que estar conectado a la red para usarlos.

Solo das click en la barra de botones, la figura que deseas hacer y arrastras con el botón medio del ratón dentro de la caja, y hacer comentarios como si fueran diagramas de flujo.



Después de hacer el comentario, solo copias y pegas en el código a tu gusto:











Aqui puedes descargar el archivo: PorkComment.rar
Cuándo te pregunte como guardarlo, escribe el nombre: PorkComment.rar
Contraseña: Dr.Wi11y

Despues de descomprimirlo, tendras que compilarlo. Usa Lazarus

Porqué razón hay que escribrirle el nombre cuando descargas?
1. Porque uso Data  Uris.
2. No se como ponerle nombre de archivo con Data Uris, se aceptan sugerencias.

Feliz Descarga















Recomendaciones:
ASCII ART
Texto con ASCII ART

No hay comentarios:

Publicar un comentario