[Embajadores-fedora-latam] 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"