Polityka dokumentacji DDP

Ta instrukcja jest trochę przeterminowana i na liście dyskusyjnej debian-doc czynione są starania aby to poprawić. Zapoznaj się z aktualnym szkicem nowej polityki.

Poniżej znajduje się lista decyzji podjętych na naszej liście dyskusyjnej. Uzyskała ona akceptację Menadżera Dokumentacji, Susan G. Kleinmann.

Wszystkie podręczniki należące do Debian Documentation Project (DDP) będą publikowane pod licencjami zgodnymi z DFSG, najcześciej GPL.

Będziemy używać następującej struktury katalogów:

System plików:

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

Serwer WWW:

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

Serwer 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

Proszę zauważyć, że ta cześć polityki nie została jeszcze globalnie zaakceptowana, niektóre adresy mogą więc nie działać. Prawdziwe położenie dokumentów może się zmieniać celem zachowania wstecznej kompatybilności.

Jako formatu źródłowego będziemy używać SGMLa.
Proszę zauważyć, że to nie oznacza potrzeby nauki SGMLa przez użytkowników celem zgłoszenia zmiań w dokumencie. Wszystkie formaty są przez nas akceptowane. Jakkolwiek, zostaną przekonwertowane w SGMLa przez kogoś z Debian-Doc.
Innymi opcjami były: LaTeX, HTML, Texingo oraz kilka innych mało znaczących formatów.
Będziemy używać debiandoc-sgml dla naszych dokumentów.
Innymi opcjami były: linuxdoc-sgml oraz DocBook. Linuxdoc nie jest już rozwijany; DocBook jest napiętnowany przez wielu jako rozwiązanie zbyt duże, zbyt skomplikowane i trudne do konfiguracji.
Każdy dokument Debiana będzie miał wymienionego jednoosobowego Opiekuna oraz możliwość posiadania dodatkowo Współopiekunów.