DDP Documentation Policy

Questo documento è obsoleto ed è in corso in un lavoro di aggiornamento nella mailing list debian-doc. Si veda la bozza corrente della new policy.

Sono qui elencate le decisioni che sono state prese nella nostra mailing list e approvate dal nostro Documentation Manager, Susan G. Kleinmann.

Tutti i manuali del Debian Documentation Project (DDP) saranno rilasciati sotto licenze DFSG-compliant, più adatte della GPL.

Useremo la seguente struttura di directory:

Filesystem:

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

WWW server:

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

FTP server:

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

Notare che questa parte della policy non è ancora stata accettata da tutti, perciò alcuni URI potrebbero non funzionare. Il vero indirizzo dei documenti potrebbe essere diverso per questioni di compatibilità.

Useremo SGML formato dei sorgenti.
Notare che ciò non significa che gli utenti dovranno imparare SGML per proporre cambiamenti ai nostri documenti. Accetteremo tutti gli altri formati come buoni. Comunque, essi sarannno tradotti in SGML da qualcuno di Debian-Doc.
Le altre opzioni erano: LaTeX, HTML, Texinfo, e diversi altri formati minori.
Useremo debiandoc-sgml per i nostri documenti.
Le altre opzioni erano linuxdoc-sgml o DocBook. Linuxdoc non è più mantenuto; DocBook è da molti giudicato come troppo grosso, complesso e difficile da personalizzare.
Ogni documento avrà una sola persona come Maintainer (Manutentore) e potrà anche avere altre persone come Co-Maintainers.