Polityka dokumentacji DDP

Ta instrukcja jest trochę przeterminowana i na liście dyskusyjnej debian-doc czynione są częściowe starania aby to poprawić. Zapoznaj się z aktualnym szkicem nowej polityki. Zaleca się, aby nowe dokumenty używały DocBook XML zamiast debiandoc-sgml.

Poniżej znajduje się lista decyzji podjętych na naszej liście dyskusyjnej. Uzyskała ona akceptację członków projektu oraz byłego Menadżera Dokumentacji, Susan G. Kleinmann (w stanie spoczynku).

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, najchętniej Docbook XML.
Proszę zauważyć, że to nie oznacza potrzeby nauki SGMLa lub XMLa przez użytkowników celem zgłoszenia zmiań w dokumencie. Wszystkie formaty są przez nas akceptowane. Jakkolwiek, zostaną przekonwertowane w SGMLa przez jednego z członków grupy.

Proszę także zauważyc, że starsze dokumenty pod opieką grupy nadal są w formacie debiandoc-sgml. Na ile pozwala na to czas, są one konwertowane do formatu DocBook XML. Format debiandoc-sgml został uznany za przestarzały.

Innymi opcjami były: LaTeX, HTML, Texingo oraz kilka innych mało znaczących formatów.
Będziemy ułatwiać życie tłumaczom używając PO.
Użycie narzędzi po4a zapewni odpowiednie środowisko tłumaczom pragnącym prowadzić tłumaczenia w formacie PO.
Każdy dokument Debiana będzie miał wymienionego jednoosobowego Opiekuna oraz możliwość posiadania dodatkowo Współopiekunów.