DDP - Política de documentació

Aquest manual està prou desactualitzat i existeix un esforç per a arreglar-ho a la llista de correu debian-doc. Vegeu l'esborrany actual de la nova política.

Aquí trobareu una llista amb les decisions que s'han pres en la nostra llista de correu i que ha estat aprovada per la nostra Gestora de la Documentació, Susan G. Kleinmann.

Tots els manuals del Projecte de documentació Debian (DDP) es faran sota llicències que compleixin les DFSG i preferiblement amb la GPL.

Usarem la següent estructura de directoris:

Sistema de fitxers:

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

Servidor WWW:

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

Servidor FTP:

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

Teniu en compte que aquesta part de la política encara no ha estat universalment acceptada, pel que algunes de les anteriors URL podrien no funcionar. La localització dels documents pot variar segons la compatibilitat cap a enradera d'aquests.

Usarem el format SGML com a font.
Teniu en compte que això no significa que els usuaris necessitin conèixer el SGML per a poder enviar canvis als documents. Acceptarem qualsevol altre format. De tota manera, aquests seran traduïts al SGML per algú de Debian-Doc.

Les altres opcions serien: LaTeX, HTML, Texinfo i els diversos formats menors.
Usarem debiandoc-sgml pels nostres documents.
Les altres opcions eren linuxdoc-sgml o DocBook. Linuxdoc ja no es mantingut i DocBook molts pensen que és massa gran, complex i difícil de personalitzar.
Cadascun dels documents de Debian tindrà a una única persona llistada com a Mantenidor, i potser tindrà gent addicional llistada com a Co-Mantenidors.