January 4th, 2006
attribX v0.1
Normalmente, y que me corrijan otros programadores, tenemos la mala costumbre de desarrollar cosas pero olvidar un aspecto fundamental como es la documentación. Esto lleva a que con el paso del tiempo, a pesar de ir acumulando una gran librería de funciones propias, sea muy poco el uso que le demos ya que olvidamos porque habiamos hecho tal o cual cosa.
Aprovechando el comienzo de un nuevo he tomado la decisión de ser un poco más ordenado en este sentido y comenzar a documentar lo que desarrollo. Como la única forma de lograr tener una documentación más o menos decente es pensar que nuestro código va a ser usado por alguien más (si solo yo lo voy a usar, ¿para que documentar? si igual me acuerdo como funciona) por lo tanto a partir de ahora voy a empezar a postear todo lo que vaya haciendo aquí, con la correspondiente documentción asociada.
Para empezar voy a publicar una clase para PHP, llamada attribX, que sirve para manejar atributos asociados a items que están almacenados en una BD. Es algo similar a la clase freetag pero que maneja atributos de cualquier tipo. (en realidad no habia analizado la freetag hasta tener lista mi clase).
Pueden descargar la clase, en su versión 0.1 y bajo licencia GPL, desde http://pviojo.net/classes/attribx/attribx-0.1.zip y la documentación correspondiente desde http://pviojo.net/classes/attribx/doc-0.1/index.html.
Espero les sea util y espero sus comentarios y aportes.
Tags: opensource, programación
4 Comments Add your own
Diego | January 4th, 2006 at 23:44
No probaste con PHPDoc?
http://www.phpdoc.de
pviojo | January 5th, 2006 at 10:36
En realidad no hasta ahora que lo mencionas. Es que cuando estuve desarronado la clase, y la documentación, no tenia acceso a Internet, por lo que me tuve que arreglar por mi cuenta, jeje.
Lo probaré a ver que tal.
pecesama | January 6th, 2006 at 1:03
Excelente iniciativa Pablo, esperamos tus otros proyectos.
Pecesama.Net [weblog] » attribX v0.1 | January 14th, 2006 at 22:24
[...] Pablo publico una interesante librería para poner atributos a items, en otras palabras poner tags a elementos de una base de datos. Para empezar voy a publicar una clase para PHP, llamada attribX, que sirve para manejar atributos asociados a items que están almacenados en una BD. Es algo similar a la clase freetag pero que maneja atributos de cualquier tipo. (en realidad no habia analizado la freetag hasta tener lista mi clase). [...]
Leave a Reply
XHTML: You can use these tags:
<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>