Die folgenden Themen müssen dringend diskutiert werden.
Unterstützung ist willkommen.
Jay Treacy hat die Diskussion über die Standardisierung von
Pfaden für Pakete angestoßen, sowohl für die Website als auch
im DDP. Mehr Informationen sind im Todo.
Wir müssen unsere Arbeit stärker mit dem LDP integrieren, da
wir es nicht alleine machen können. Einige haben sich bereits
gemeldet, um einige der LDP-Dokumente zu paketieren.
Es ist noch nicht vollkommen klar, was getan werden muss,
damit debiandoc-sgml mit mehreren Sprachen zusammenarbeitet.
Einige haben angefangen, einen grove-based SGML structure
extractor zu entwickeln, der dabei hilft, strukturelle
Ähnlichkeiten zwischen verschiedenen Übersetzungen eines
Dokuments beizubehalten. Wir wissen, dass die Benennung von
erzeugten Dateien möglicherweise geändert oder nachbearbeitet
werden muss, um Dokumente in Webspace mit Content-Negotiation anzubieten.
Andere Probleme müssen identifiziert werden.
Die Frage ist, wie Dokumente zu paketieren sind. Ein Paket pro Dokumentation hat die folgenden Vorteile:
Hier ist ein Vorschlag (der leicht veraltet ist). Die aktuelle Meinung ist, dass Handbücher in ihren eigenen Paketen stecken sollten, es sei denn, sie sind sehr klein. Dass sie so unter Zuhilfenahme des BTS gepflegt und verwaltet werden können und dass die Möglichkeit besteht, neue Versionen ohne großen Aufwand herauszubringen, überwiegt über eine Reduzierung der Pakete.
Ich schlage die folgenden Debian-Pakete vor:
| Debian-Pakete | Dokumente |
|---|---|
| debian-doc | META-Handbuch, Hardware-Kompatibilitäts-Liste, Installations-Handbuch, Release Notes, FAQ, Debian-Tipps, Debian-Linux-Benutzerhandbuch, Debian System-Administrator-Handbuch |
| debian-policy | Richtlinien-Handbuch |
| debian-doc-dev | Projekt-Handbuch, Entwickler-Referenz-Handbuch, Programmierer-Handbuch, Ein Debian-Paket erstellen, Paketierungs-HOWTO, Dokumentations-Richtlinien, Wie man mit SGML beginnt |
| dpkg-dev | dpkg Reference Manual, dpkg Internals |
Beachten Sie, dass ich vorschlage, doc-debian in debian-doc umzubenennen, da ich den letzteren Namen viel besser finde.
(by Adam Di Carlo (?))
Brauchen wir noch irgendwelche Richtlinien-Stellungnahmen zu den angesprochenen Themen?