Следующие задачи срочно требуют рассмотрения, обсуждения или
помощи добровольцев.
Джей Треси (Jay Treacy) предложил стандартизовать расположение
файлов в пакетах, на web-сайте и, вероятно, в DDP. См. более
подробную информацию в списке текущих задач.
Нам следует более тесно сотрудничать с проектом LDP, поскольку мы
не можем делать всё это самостоятельно. Некоторые шаги к совместной
работе в виде создания пакетов документов LDP уже предприняты.
Пока не совсем ясно, что именно нужно сделать, чтобы 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) (?))
Требуются ли нам для этого какие-то поправки к политике?