Re: [Cuadrantes-espiral] Manual para desarrolladores

[Javier Linares]

Hola,

Sigo con el tema del manual. He incluido los mensajes más
interesantes de la lista (cosas como el anillo de confianza y el
manual de sesiones remotas en Linux) y el PDF va por unas 21
páginas.

Si alguien está interesado en incluir un capítulo hablando de
algún tema de la web, este es el momento. Lo que llevo del
documento incluye muchas cosas que han pasado por los foros y
nuevas propuestas de estándares a cumplir a la hora de introducir
cosas en el servidor (como crear un documento .readme con
determinados campos) que ya comentaremos una vez que el documento
esté listo y descartaremos los que nos parezcan demasiado
restrictivos.

Para enviarme capítulos lo más cómodo (al menos para mi) es que
ya estén en XML. A continuación adjunto un ejemplo de documento
en XML (utilizando la DTD llamada docbook). No hay que tenerle
miedo :), porque aunque son muchas etiquetas las posibles, en la
práctica se utiliza un número muy reducido de ellas. Y se escribe
en cualquier editor de texto plano, así que tampoco son
necesarias herramientas adicionales.

Saludos,

---------------------------------------------------------------


<?xml version="1.0" encoding="ISO-8859-1" ?>

<chapter><title>Modo de trabajo del equipo desarrollador</title>

<para>El equipo que actualmente desarrolla y administra
lawebespiral.org se coordina a través de una lista de
distribución <footnote><para>Agradecemos a la <foreignphrase>Free
Software Foundation</foreignphrase> el alojamiento de la lista de
correo y los archios de los mensajes enviados en sus
servidores</para></footnote> cuyos archivos puedes encontrar en
la dirección <ulink url="http://lawebespiral.org/admin";>
http://lawebespiral.org/admin</ulink> y puedes
enviar tus mensajes a la dirección <ulink
url="mailto:address@hidden";>address@hidden</ulink>.
</para>

<sect1><title>Título de una sección</title>
<para>Párrafo de ejemplo.</para>

        <sect2><title>Título de una subsección dentro de una
        sección</title>

        <para>Párrafo de ejemplo</para>

        </sect2>
</sect1>

<para>La mayoría de los mensajes técnicos y sobre decisiones
rápidas van por la lista de correo, pero también contamos con un
hueco en los <emphasis>foros</emphasis> de la web, para los
anuncios de las novedades y para pedir opinión a los usuarios
quep articipan activamente en la web.</para>

</chapter>

------------------------------------------------------------------

-- 
Javier Linares                  http://www.adala.org
address@hidden        address@hidden