Normativa de Documentación del DDP

Este manual está un tanto obsoleto y hay en marcha un esfuerzo para corregirlo en la lista de correo debian-doc. Consulte el borrador de la nueva normativa.

A continuación aparece una lista de decisiones que se tomaron en la lista de distribución y que fueron aprobadas por la Jefa de Documentación, Susan G. Kleinmann.

Todos los manuales del Proyecto de Documentación de Debian (DDP) se publicarán bajo licencias que cumplan la DFSG y preferiblemente GPL.

Utilizaremos la siguiente estructura de directorios:

Sistema de ficheros:

  /usr/share/doc/manuals/el_manual/index.html
  /usr/share/doc/manuals/el_manual.ps.gz (opcional)

Servidor WWW:

  http://www.debian.org/doc/manuals/el_manual/

Servidor FTP:

  http://ftp.debian.org/debian/doc/manuals/el_manual.html.tar.gz
  http://ftp.debian.org/debian/doc/manuals/el_manual.text.gz
  http://ftp.debian.org/debian/doc/manuals/el_manual.dvi.gz
  http://ftp.debian.org/debian/doc/manuals/el_manual.ps.gz
  http://ftp.debian.org/debian/doc/manuals/el_manual.sgml.tar.gz

Por favor, tenga cuenta que esta parte de la normativa no ha sido universalmente aceptada aún, por lo que algunas de las URL's anteriores bien pueden no funcionar. La localización real de los documentos puede variar en función de la compatibilidad con versiones anteriores).

Utilizaremos SGML como formato de los archivos fuente.
Observe que esto no significa que los usuarios necesiten conocer SGML para poder enviar cambios a los documentos. Aceptaremos cualquier otro formato. En cualquier caso serían traducidos a SGML por alguien de Debian-Doc.
Las otras posibilidades serían: LaTeX, HTML, Texinfo y varios otros formatos menores.
Utilizaremos debiandoc-sgml para nuestros documentos.
Las otras opciones eran linuxdoc-sgml o DocBook. Linuxdoc ya no se mantiene; por otra parte, mucha gente piensa que DocBook es demasiado grande y complejo y difícil de personalizar.
Cada Documento de Debian tendrá una única persona listada como Mantenedor y puede tener a varias personas listadas como Co-Mantenedores.