Asuntos pendientes del DDP
Las siguientes cuestiones necesitan ser consideradas, discutidas o
atendidas por voluntarios de forma inmediata o apremiante.
- Integración del DDP y www.debian.org
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.
- Cooperación con el LDP
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.
- Hacer que debiandoc-sgml no tenga problemas de
Internacionalización
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.
- Asuntos referentes a la documentación en los paquetes.
La cuestión es cómo se corresponden los documentos a los paquetes. Tener un paquete por documento tiene las siguientes ventajas:
- Los paquetes serán pequeños. Si se actualiza sólo un documento, no hay que descargarlos todos.
- Las cosas son más claras en el caso de que el mantenedor del paquete sea también el mantenedor (autor) del documento.
- Se puede informar de forma sencilla sobre fallos en documentos.
- Ya tenemos bastantes paquetes y algunos usuarios se quejan de que son demasiados.
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?