Antes de distribuir su código a millones de lectores potenciales, hay unas cuantas cosas que debería hacer.
Primero, asegúrese de corregir la ortografía de su documento. La mayoría de las utilidades que empleará para escribir en SGML poseen aplicaciones para la corrección ortográfica. Si no es así, siempre está el programa aspell.
Segundo, pida a alguien que revise el documento para verificar su exactitud. La documentación publicada por el LDP debe ser lo más precisa posible en relación con los hechos, ya que millones de usuarios de Linux pueden estar leyéndola. Si participa en alguna lista de correo sobre la materia en cuestión, pida a alguien de la lista que le eche una mano.
Tercero, cree un sitio web donde pueda distribuir su documentación. Esto no es estrictamente necesario, pero es útil para que algunas personas encuentren la ubicación del original de su documentación.
Usando Jade, o cualqier otra orden nsgmls, Usted puede validar su código .sgml contra la DTD para asegurarse de que no existe ningún error.
bash$ nsgmls -s HOWTO-HOWTO.sgml |
Si no hay problemas, se le devolverá a su línea de órdenes.
Para que un documento sea aceptado por el LDP, debe ajustarse a la sección "LICENSE REQUIREMENTS" del Manifiesto del LDP, que se encuentra en http://www.linuxdoc.org/manifesto.html. Como autor, puede conservar el copyright y añadir ciertas restricciones (por ejemplo, puede dar el visto bueno a una traducción u otros trabajos derivados). Dispone de un ejemplo en el Manifiesto o en http://www.linuxdoc.org/COPYRIGHT.html. Si elige emplear el copyright estándar, simplemente cópielo en su código fuente en una sección llamada "Copyright y Licencias" o algo similar. Incluya también su propia declaración de copyright (¡es suyo!). Si Usted colabora en un CÓMO ya existente, debe incluir las declaraciones de copyright del autor o autores previos y las fechas en las que trabajaron en ese documento.
Observe que la licencia del Cómo-de-CÓmos obliga a notificar al autor cualquier traducción o trabajo derivado de éste. En mi caso, también coloco explícitamente cualquier código fuente (además del SGML en el que se escribió el CÓMO) bajo licencia GPL. Debería hacer lo mismo, si su CÓMO incluye trozos de código fuente que quiera poner a disposición de los demás usuarios.
Una vez que su documento ha sido revisado cuidadosamente, puede publicarlo en el LDP. Envíe un e-mail con el código fuente en SGML como un archivo adjunto (utilice gzip si lo desea) a <ldp-submit@lists.linuxdoc.org>.
Asegúrese de incluir el nombre de su CÓMO en la línea del asunto, utilice el cuerpo para explicar los cambios que ha realizado y adjunte su CÓMO. Esto permite a los colaboradores realizar su trabajo con mayor rapidez, de manera que no tiene que esperar mucho para ver su CÓMO actualizado en el sitio web del LDP. Si no tiene noticias en 7 días, le rogamos que se ponga en contacto con nosotros via e-mail para asegurarse de que las cosas están todavía en proceso.
Si su CÓMO contiene extras, imágenes o un catálogo especial, cree un fichero .tar.gz que contenga todos los ficheros, incluyendo el código fuente .sgml, y envíelo como un archivo adjunto a la lista ldp-submit.
Ahora que Usted es autor de un CÓMO, debería mantener el documento y actualizarlo cuando se hagan públicas las nuevas versiones de software. También debería responder a los comentarios y preguntas razonables de sus lectores. No tiene que ayudarlos a todos, especialmente si sus preguntas se responden en el CÓMO. Sin embargo, una buena experiencia con el LDP por parte de los lectores es uno de nuestros objetivos y una excelente manera de aumentar la popularidad de Linux.