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.
