SGML/XML, creando documentación
Según he estado leyendo por internet hay varias herramientas para la creación de documentación específica. Me explico. A la hora de documentar un proyecto nos basta con un editor de texto normal, pero esto limita mucho, tanto la maquetación del texto como el formato del mismo (si bien el txt es legible en todas las plataformas, no nos permite la introducción de fotos/gráficos...)Para ello hay una serie de herramientas disponibles, tenemos un claro ejemplo en la página web de Ismael Olea (hispalinux) donde tiene colgada una conferencia sobre todo esto, dentro de esa conferencia podemos ver un ejemplo de las nuevas herramientas SGML, que permiten exportar el mismo "código fuente" de documento a varios formatos.
Ahora solamente nos queda ponernos a pasar nuestros documentos a Docbook (una librería de maquetación, por llamarla de alguna forma, de documentos especificamente informáticos). Animaos, merece la pena.
Para los BSDeros podeis obtener todas las herramientas que necesitamos en los ports (/usr/ports/textproc/sgmltools), para los Slackeros, os dejo el paquete necesario(sgml-tools-1.0.9-i386-7.tgz, 6.5Mb), installpkg y a funcionar con ello. Debian supongo que tendrá algo parecido en su apt y para el resto de distros seguro que hay RPM's por ahí.
Ahora si que no teneis excusa!