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.
No probaste con PHPDoc?
http://www.phpdoc.de
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.
Excelente iniciativa Pablo, esperamos tus otros proyectos.
[...] 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). [...]