Facilitar la documentación con Sphinx

[María Leandro]

Saludos chic@s

Ayer en reunión de trabajo y hablando sobre documentación, vi un poco la
herramienta Sphinx [1] la cual no es un cms, ni un wiki; pero con ingreso de
escritura en texto simple (texto) lo convierte a cualquier formato que
deseemos. Es un simple generador de documentos que quizá nos pueda servir
para ir desarrollando poco a poco manuales de usuario, tutoriales de
empaquetado; que pueden ser fácilmente impresos y distribuidos.

Lo interesante de esta herramienta es que está basada en texto
reestructurado (reStructuredText) lo cual nos facilita mucho el trabajo de
edición. Muchas veces nos abstenemos de colaborar en la wiki porque nos
aburre dar formato a las cosas, y quizá escribiendo de esta forma nos sea
mucho más fácil, ya que podemos usar gedit, vi o incluso nuestro tlf celular
para enviar tips o docs.

En fin, se los dejo para que le den un vistazo y veamos si lo implementamos
para hacer algunas pruebas y su feedback :)


[1] http://sphinx.pocoo.org/


Feliz día!


-- 
tatica
Maria Gracia Leandro
http://www.tatica.org
http://www.fedora-ve.org
http://fedoraproject.org/wiki/MariaLeandro
LinuxUser= 440285
GPG Public Key: E1CDCC56
"Be yourself... Don't be anyone else"

[María Leandro]

Saludos!

Tenemos un nuevo miembro que está a punto de convertirse en embajador.
Ricardo estará comenzando a trabajar con Sphinx para tratar de buscar formas
más fáciles de incentivar a "todos" a que documentemos más.


Bienvenido Ricardo!

El 9 de junio de 2010 08:54, María Leandro <tatica(a)fedoraproject.xn--org&gt;escribi-yob:

>  Saludos chic@s
>
>  Ayer en reunión de trabajo y hablando sobre documentación, vi un poco la
>  herramienta Sphinx [1] la cual no es un cms, ni un wiki; pero con ingreso de
>  escritura en texto simple (texto) lo convierte a cualquier formato que
>  deseemos. Es un simple generador de documentos que quizá nos pueda servir
>  para ir desarrollando poco a poco manuales de usuario, tutoriales de
>  empaquetado; que pueden ser fácilmente impresos y distribuidos.
>
>  Lo interesante de esta herramienta es que está basada en texto
>  reestructurado (reStructuredText) lo cual nos facilita mucho el trabajo de
>  edición. Muchas veces nos abstenemos de colaborar en la wiki porque nos
>  aburre dar formato a las cosas, y quizá escribiendo de esta forma nos sea
>  mucho más fácil, ya que podemos usar gedit, vi o incluso nuestro tlf celular
>  para enviar tips o docs.
>
>  En fin, se los dejo para que le den un vistazo y veamos si lo implementamos
>  para hacer algunas pruebas y su feedback :)
>
>
>  [1] http://sphinx.pocoo.org/
>
>
>  Feliz día!
>
>
>  --
>  tatica
>  Maria Gracia Leandro
>  http://www.tatica.org
>  http://www.fedora-ve.org
>  http://fedoraproject.org/wiki/MariaLeandro
>  LinuxUser= 440285
>  GPG Public Key: E1CDCC56
>  "Be yourself... Don't be anyone else"
>  


-- 
tatica
Maria Gracia Leandro
http://www.tatica.org
http://www.fedora-ve.org
http://fedoraproject.org/wiki/MariaLeandro
LinuxUser= 440285
GPG Public Key: E1CDCC56
"Be yourself... Don't be anyone else"