DDPs aktuelle emner
Følgende punkter kræver omgående eller snarlig overvejelse, diskussion
eller hjælp fra frivillige.
- Integration af DDP og www.debian.org
Jay Treacy har åbnet en debat om standardisering af filplaceringer i pakker, på webstedet og muligvis indenfor DDP. Se "todo" for flere oplysninger
- Samarbejde med LDP
Vi skal integreres mere med LDP-projektet, da vi ikke kan gøre det alene. Nogle har meldt sig til at pakke nogle af LDPs dokumenter.
- Gøre debiandoc-sgml brugbar til internationalisering
Det er endnu ikke helt klart hvad der skal gøre ved debiandoc-sgml, for at køre det anvendeligt i forbindelse med flere sprog. Nogle er begyndt at arbejde på et grundlæggende grove-baseret udtræksprogram som anvender SGML-strukturer, hvilket gør det nemmere at bibeholde en strukturel lighed mellem forskellige oversættelser af et dokument. Vi véd at navngivelse af fil-uddata måske skal ændres eller efterbehandles hvad angår dokumenter som indgår i websteders indholdsforhandling. Andre problemer skal identificeres.
- Problemer med at pakke dokumentation
Spørgsmålet er hvordan dokumenter sættes i forbindelse med pakker. At have en pakke per dokument har følgende fordele:
- Pakkerne vil være små. Hvis et enkelt dokument opdateres, er man ikke nødt til at hente alle dokumenterne.
- Det er nemmere at forstå, at pakkevedligeholderen også er dokumentvedligeholderen (dvs., forfatter).
- Det er nemt at rapportere fejl i dokumenter.
- Vi har i forvejen mange pakker, og nogle brugere klager allerede over at der er for mange.
Her er et foreslag (som nok er lidt forældet). Den nuværende tankegang er, at vejledninger skal have deres egne pakker, med mindre der er meget små. Opfølgningens muligheden som man får via fejlrapporteringssystemet og muligheden for at udsende nye versioner uden problemer, synes at være vigtigere end det mindre punkt, at formindske antallet af pakker.
Jeg foreslår følgende Debian-pakker:
Debian-pakke Dokumenter debian-doc META Manual, Hardware Compatibility List, Installation Manual, Release Notes, FAQ, Debian Tips, User's Manual, Debian System Administrators Manual debian-policy Policy Manual debian-doc-dev Project Manual, Developers Reference Manual, Programmer's Manual, Making a Debian Package, Packaging HOWTO, Documentation Guidelines, How to get started with SGML dpkg-dev dpkg Reference Manual, dpkg Internals Bemærk at jeg foreslår at doc-debian omdøbes til debian-doc, da jeg synes at sidstnævnte navn er meget bedre.
(af Adam Di Carlo (?))
Har vi brug for noget i vores retningslinier om denne problemstilling?