Las siguientes cuestiones necesitan ser consideradas, discutidas o
atendidas por voluntarios de forma inmediata o apremiante.
Jay Treacy ha abierto el asunto sobre estandarizar los lugares donde deben estar los paquetes, el sitio web, y probablemente dentro del DDP. Véase PorHacer si desea más información.
Necesitamos estar más integrados con el proyecto LDP, ya que no
podemos hacer esto solos. Algunos han dado el paso de empaquetar algunos
de los documentos del LDP.
No está del todo claro aún qué se ha de hacer para que debiandoc-sgml
sea conveniente para varias lenguas. Se ha empezado a trabajar en un
extractor básico de la estructura SGML basado en grove, que ayuda a
mantener una similaridad estructural entre diferentes traducciones de un
mismo documento. Sabemos que puede hacer falta cambiar o post-procesar
los nombres de los ficheros de salida en espacios web con negociación de
contenido. Hace falta identificar otros problemas.
La cuestión es cómo se corresponden los documentos a los paquetes. Tener un paquete por documento tiene las siguientes ventajas:
Hay una propuesta (probablemente un tanto obsoleta). El pensamiento actual es que los manuales deberían residir en sus propios paquetes, a menos que sean muy pequeños. El sistema de registro proporcionado por el BTS y la posibilidad de entregar versiones nuevas sin mucha alharaca parece minimizar la reducción de paquetes.
Sugiero los siguientes paquetes de Debian:
| Paquete Debian | Documentos |
|---|---|
| debian-doc | META Manual, Lista de compatibilidad de Hardware, Manual de instalación, Notas de publicación (release notes), FAQ, Consejos de Debian, Manual del usuario, Manual del administrador de sistemas Debian |
| debian-policy | Manual de normativa (Debian Policy) |
| debian-doc-dev | Manual del proyecto, Manual de referencia para desarrolladores, Manual del programador, Cómo hacer un paquete de Debian, Cómo empaquetar (Packaging HOWTO), Directivas para la documentación (Guidelines), Cómo empezar con SGML |
| dpkg-dev | Manual de referencia de dpkg, Interioridades de dpkg |
Fíjese que sugiero cambiar el nombre de doc-debian por debian-doc ya que pienso que el segundo nombre es mucho mejor.
(por Adam Di Carlo (?))
¿Necesitamos algún tipo de normativa sobre este tema?