Список текущих задач DDP

Список срочных задач:

Безжалостное уничтожение устаревшей документации.
Разработать и задокументировать иерархию документации. Главным образом, закончить документ Политика Документации, согласовав с командой разработки web-сайта Debian, включая целостность и согласованность файлов на web-сайте и в пакетах. Черновик доступен здесь, но он ещё требует переработки.
Разработать способ автоматического контроля переводов, как это сделано с исходными файлами web-страниц на WML.
Определить, какую информацию нужно помещать на компакт-диски и автоматизировать создание корректного индекса. Необходимую информацию можно найти здесь. В репозитории subversion хранится несколько скриптов, которые нужно отшлифовать и добавить к задачам cron.

Идеи:

Дальнейшее — это лишь список идей, высказанных в нескольких дискуссиях в нашем списке рассылки. Так что здесь могут быть как хорошие, так и плохие идеи. :-)

Создать единый интерфейс доступа ко всем страницам руководств системы Debian, как сделано во многих других местах: FreeBSD, NetBSD, OpenBSD, HP (HPUX), IBM (AIX), SGI (Irix) и Sun (Solaris). Забавно, что на нескольких серверах (например, Fifi) интерфейс ко всем страницам руководств Debian уже есть. Это ошибка #264589. Первая бета-версия доступна по адресу manpages.debian.net, но в настоящее время недоступна.
Реализовать URN. Это позволит пользователям просматривать документацию локально, на web-сайте или на зеркалах. Для задания более близких или более удобных зеркал, либо их приоритета могут использоваться локальные настройки. Система doc-base также могла бы использовать для адресации документов URN вместо имён файлов.
Я подумал о выходных форматах, которые мы хотим включать в пакеты Debian (.deb). Мы должны включать HTML (это политика), но некоторые люди могут хотеть иметь также версию на PostScript или текстовую. У меня появилась идея распространять _только_ исходные файлы на SGML и создавать документацию в тех форматах, которые нужны пользователю, на его машине (как во время установки, так и позднее). У этого способа есть несколько преимуществ:
- файлы .deb будут маленькими
- наибольшая гибкость
- мы можем даже подогнать ссылки при компиляции документов, т.е. заменить Интернет-ссылки локальными, если файлы есть в наличии !!!
- вероятно, проще будет сохранять актуальность общего указателя (а-ля dwww)
Недостатки, которые я вижу:
- людям придётся устанавливать debiandoc-sgml (но он невелик)
- форматирование займёт некоторое время (не очень большое, но простая распаковка была бы быстрее)
doc-base может определять основные принципы таких систем, поскольку он отслеживает лишь метаданные документов.
Определить, какие документы реально используются (или ищутся) нашими пользователями, чтобы мы могли сконцентрировать усилия на них. Пока этот вопрос не изучался. Источниками информации могут быть списки рассылки для пользователей (провести опрос), статистика посещений сайта (или сайта и его зеркал), а также, поскольку документы распространяются и в виде пакетов Debian, данных popularity-contest.
Генерировать информацию о доступных руководствах, представленных на сайте, извлекая информацию автоматически из CVS (из файлов manual.defs и version.defs).
Реализовать возможность отслеживания состояния перевода на основе информации CVS. Возможно использование инфраструктуры, разработанной командой разработки debian-installer для руководства по установке.
Отслеживать дату последнего изменения документа, чтобы пользователи, просматривая документы, знали, насколько он является актуальным.
Разработать инфраструктуру предоставления пользователям документации на языках, отличных от английского (для некоторых языков в CVS есть каталоги, а некоторые документы изначально написано на отличном от английского языке)
Разработать интерактивный механизм комментирования документов пользователями (интерфейс, аналогичный wiki), отдельно от представления документа на сайте или в рамках того же представления. Такая обратная связь может использоваться авторами документа и хорошо зарекомендовала себя в других проектах поддержки документации, даже если замечания не модерируются (PHP).
Предоставить пользователям единую систему отслеживания ошибок в документации. Нынешняя система отслеживания ошибок используется для документов, распространяемых в виде пакетов, но к их числу относятся не все документы.