DDP Documentatie Beleid

Deze handleiding is nogal achterhaald en er is een poging om het te herstellen op de debian-doc mailinglijst . Zie de huidige kladversie van het nieuwe beleid.

Hier is een lijst van beslissingen die gemaakt zijn op onze mailinglijst en goedgekeurd door onze Documentatie Manager, Susan G. Kleinmann.

Alle handleidingen van het Debian Documentatie Project (DDP) zullen worden uitgebracht onder licenties die zich houden aan de DFSG, waarschijnlijk GPL.

We zullen de volgende mapstructuur gebruiken:

Bestandssysteem:

  /usr/share/doc/manuals/handleiding/index.html
  /usr/share/doc/manuals/handleiding.ps.gz (optioneel)

WWW-server:

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

FTP-server:

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

Merk op dat dit deel van het beleid nog niet universeel aanvaard is, dus het kan zijn dat deze URI's niet werken. De werkelijke locaties van deze documenten kan variëren wegens achterwaartse compatibiliteit.

We zullen SGML als bronformaat gebruiken.
Merk op dat dit niet betekent dat gebruikers SGML moeten leren om wijzigingen voor de documenten door te sturen. We aanvaarden ook alle andere formaten. Hoewel, ze zullen worden vertaald in SGML door één van de Debian-Doc mensen.
De andere opties zijn: LaTeX, HTML, Texinfo, en verschillende andere weiniggebruikte formaten.
We zullen debiandoc-sgml gebruiken voor onze documenten.
De andere opties waren linuxdoc-sgml of DocBook. Linuxdoc wordt niet langer beheerd; DocBook wordt door velen als te groot en te complex beschouwd en is moeilijk aan te passen aan ieders wensen.
Elk Debian-document zal één enkele persoon als Beheerder hebben en kan ook nog Co-Beheerders hebben.