Текущие области работы DDP
Следующие задачи срочно требуют рассмотрения, обсуждения или
помощи добровольцев.
- Интеграция DDP и www.debian.org
Джей Треси (Jay Treacy) предложил стандартизовать расположение файлов в пакетах, на web-сайте и, вероятно, в DDP. См. более подробную информацию в списке текущих задач.
- Сотрудничество с LDP
Нам следует более тесно сотрудничать с проектом LDP, поскольку мы не можем делать всё это самостоятельно. Некоторые шаги к совместной работе в виде создания пакетов документов LDP уже предприняты.
- Сделать debiandoc-sgml более интернационализируемым
Пока не совсем ясно, что именно нужно сделать, чтобы debiandoc-sgml лучше работал с разными языками. Кое-кто начал разрабатывать способ извлечения основное лесовидной структуры SGML, что позволит сохранять схожесть структуры различных переводов документа. Мы знаем, что схема именования выходных файлов, для того чтобы их можно было поместить на web-страницы с согласованием содержания, должна быть изменена или подвергнута обработке после компиляции документа. Могут возникнуть и другие проблемы.
- Вопросы с созданием пакетов документации.
Вопрос состоит в том, как документ соотносится с пакетами. Возможность иметь один пакет на документ даёт следующие преимущества:
- Пакеты будут маленькими. Если обновляется один документ, не нужно загружать все.
- Проще, если сопровождающий документа (т.е. автор) является также сопровождающим пакета.
- Проще отправлять сообщения об ошибках в документах.
- У нас уже вполне достаточно пакетов, и некоторые пользователи уже жалуются, что их слишком много.
Предлагаю следующее (вероятно, предложение немного устарело). Нынешняя точка зрения состоит в том, что руководства должны находиться вне пакетов своих программ, кроме случае, если они очень маленькие. Точное определение ответственности благодаря BTS и возможность распространять новые версии без особой суеты, по всей видимости, перевешивают недостатки разбиения пакетов.
Я предлагаю следующие пакеты Debian:
Пакет Debian Документы debian-doc Метаруководство, Список совместимого аппаратного обеспечения, Руководство по установке, Информация о выпуске, FAQ, Советы Debian, Руководство пользователя, Руководство системного администратора Debian debian-policy Руководство по политике debian-doc-dev Руководство по проекту, Справочное руководство разработчика, Руководство программиста, Создание пакета Debian, HOWTO: Создание пакетов, Руководство по документированию, Как начать работу с SGML dpkg-dev Справочное руководство по dpkg, Внутреннее устройство dpkg Заметьте, что я предлагаю переименовать doc-debian в debian-doc, поскольку считаю это имя более адекватным.
(Адам ди Карло (Adam Di Carlo) (?))
Требуются ли нам для этого какие-то поправки к политике?