La politique de documentation DDP

Ce document obsolète est en cours de réélaboration sur debian-doc@lists.debian.org. Vous pouvez lire une première ébauche de cette nouvelle politique de documentation.

Voici les décisions prises sur notre liste de diffusion et approuvées par l'administrateur de la documentation, Susan G. Kleinmann.

Tous les manuels du projet de documentation Debian (DDP) sortiront sous licences conformes aux DFSG, très probablement GPL.

Nous utiliserons la structure de répertoire suivante :

Système de fichiers :

  /usr/share/doc/manuals/somemanual/index.html
  /usr/share/doc/manuals/somemanual.ps.gz (optional)

Serveur WWW :

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

Serveurs FTP :

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

Ce point de la charte n'étant pas encore universellement accepté, ces URI peuvent ne pas marcher. Les emplacements exacts des documents peuvent varier pour des raisons de compatibilité ascendante.

Nous utiliserons le SGML comme format source.
Cela ne signifie pas que les utilisateurs doivent apprendre le SGML pour soumettre des changements à nos documents. Nous acceptons aussi bien d'autres formats. Quoi qu'il en soit, ils seront traduits en SGML par une des personnes de Debian-Doc.
Les autres options sont : LaTeX, HTML, Texinfo, et plusieurs autres formats mineurs.
Nous utiliserons debiandoc-sgml pour nos documents.
Les autres options étaient linuxdoc-sgml ou DocBook mais Linuxdoc n'est plus maintenu et DocBook est jugé trop gros, trop complexe et trop difficile à personnaliser.
Chaque document Debian n'aura qu'un seul responsable et pourra avoir éventuellement d'autres personnes considérées comme coresponsables.