DDP dokumentacijska načela

Ovaj priručnik je prilično zastario i postoji napor da se ispravi na debian-doc mailing listi. Pogledajte trenutni prijedlog novih načela.

Ovo je popis odluka koje su donešene na našoj mailing listi i odobrena od našeg `Documentation Managera', Susan G. Kleinmann.

Svi priručnici Debian dokumentacijskog projekta (DDP-a) će biti objavljeni pod DFSG-prihvatljivim licencama, najvjerojatnije GPL.

Koristit ćemo sljedeću strukturu direktorija:

Datotečni sustav:

  /usr/share/doc/manuals/nekipriručnik/index.html
  /usr/share/doc/manuals/nekipriručnik.ps.gz (opcija)

WWW poslužitelj:

  http://www.debian.org/manuals/nekipriručnik/index.html

FTP poslužitelj:

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

Molimo primijetite da ovaj dio načela još nije općeprihvaćen, pa ovi URI-ji nužno ne rade. Prave lokacije dokumenata bi se mogle razlikovati zbog kompatibilnosti unazad.

Koristit ćemo SGML kao format izvornika.
Primijetite da ovo ne znači da će korisnici morati naučiti SGML kako bi poslali promjene za naše dokumente. Prihvaćamo i sve druge formate. Ipak, oni će biti prevedeni u SGML od Debian-Doc ljudi.
Druge opcije su bili: LaTeX, HTML, Texinfo, i mnogi drugi minorni formati.
Koristit ćemo debiandoc-sgml za naše dokumente.
Druge opcije su bili linuxdoc-sgml ili DocBook. Linuxdoc se više ne održava; DocBook je prema procjeni mnogih prevelik i kompleksan i težak za vršenje promjena.
Svaki Debian dokument će imati jednu osobu popisanu kao Održavatelja a može imati i dodatne ljude popisane kao Ko-Održavatelje.