De volgende zaken hebben dringend aandacht, discussie of helpende
vrijwilligers nodig.
Jay Treacy heeft het onderwerp aangebracht van standaard bestandslokaties
voor pakketten, voor de website en waarschijnlijk in het DDP. Zie
Todo voor meer informatie.
We moeten meer geïntegreerd worden met het LDP-project, want we kunnen
het niet alleen aan. Sommigen hebben zich aangeboden om enkele LDP-documenten
in pakketten te stoppen.
Het is nog niet helemaal duidelijk wat gedaan moet worden om debiandoc-sgml
meertalig te maken. Enkelen zijn gestart met het werken aan een basis
grove-gebaseerde SGML-structuurextractor, die helpt om de structurele
eenvormigheid tussen verschillende vertalingen van één document te
behouden. We weten dat bestandsnamen misschien gewijzigd moeten worden of
nog extra moeten verwerkt worden voor documenten in webcontext waar
onderhandeld wordt over de inhoud. Andere problemen moeten worden
geïdentificeerd.
De vraag is hoe documenten correleren met pakketten. Het hebben van één pakket per document heeft volgende voordelen:
Hier is een voorstel (dat waarschijnlijk een beetje achterhaald is). Momenteel gaat men ervan uit dat handleidingen in hun eigen pakket horen, tenzij ze zeer klein zijn. De verantwoordelijkheid door de koppeling met de BTS en de mogelijkheid om zonder problemen nieuwe versies uit te brengen lijken het zwakke punt van het aantal pakketten te verminderen, te overtreffen.
Ik stel de volgende Debian-pakketten voor:
| Debian-pakket | Documenten |
|---|---|
| debian-doc | META Handleiding, Hardware Compatibiliteitlijst, Installatiehandleiding, Release Notes, FAQ, Debian Tips, Gebruikershandleiding, Debian Handleiding Systembeheer |
| debian-policy | Policy Manual |
| debian-doc-dev | Projecthandleiding, Referentiehandleiding voor Ontwikkelaars, Programmeerhandleiding, een Debian-pakket Maken, Packaging HOWTO, Documentatierichtlijnen, Hoe beginnen met SGML |
| dpkg-dev | dpkg Referentiehandleiding, dpkg Intern |
Merk op dat ik suggereer om doc-debian te hernoemen naar debian-doc omdat ik de laatste naam veel beter vind.
(door Adam Di Carlo (?))
Hebben we een beleidsstandpunt nodig over deze zaak?