DDP's dokumentationsfremgangsmåde

Denne håndbog er meget forældet og på postlisten debian-doc arbejdes der på at få den ajourført. Se det aktuelle udkast af de nye regler.

Her er en liste over beslutninger som blev taget på vores postliste og godkendt af vores dokumentationsbestyrer, Susan G. Kleinmann.

Alle håndbøger i Debians dokumentationsprojekt (DDP) udgives under licenser der svarer til DFSG, sandsynligvis GPL.

Vi anvender følgende mappestruktur:

Filsystem:

  /usr/share/doc/manuals/enhåndbog/index.html
  /usr/share/doc/manuals/enhåndbog.ps.gz (valgfri)

www-server:

  http://www.debian.org/doc/manuals/enhåndbog/

ftp-server:

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

Bemærk at denne del af fremgangsmåden ikke er accepteret overalt endnu, derfor virker disse URI'er måske ikke. De reelle dokumentplaceringer kan være forskellige af hensyn til bagudkompatibilitet.

Vi anvender SGML som kilde-format.
Bemærk at dette ikke betyder at brugere er nødt til at lære SGML, for at kunne indsende ændringer til vore dokumenter. Vi accepterer også alle andre formater. Men de vil blive oversat til SGML af en af Debian-Doc-folkene.
De øvrige muligheder var: LaTeX, HTML, Texinfo, og flere andre mindre udbredte formater.
Vi anvender debiandoc-sgml til vore dokumenter.
De øvrige muligheder var linuxdoc-sgml eller DocBook. Linuxdoc vedligeholdes ikke mere; DocBook anslås af mange til at være for stor, kompleks og besværlig at tilpasse.
Alle Debian-dokumenter vil have én person anført som vedligeholder og kan have flere personer anført som vedligeholdelsesmedhjælpere.