KM> Есть компонент Docs, по факту много лет неиспользуемый и отражающий KM> ныне не существующую структуру документации. По идее, его нужно KM> почистить от неактуальных ошибок и упразднить. Это обязательно (можно почистить, упразднить и создать новый). KM> Либо наполнить новым содержанием. Мне представляется осмысленным в KM> разделе "Документация" в багзилле использовать двухуровневую KM> структуру: Дистрибутив (с конкретной версией) / Руководство (в KM> одном дистрибутиве может быть по нескольку руководств) KM> Руководство соответствует в нашей терминологии выпуску KM> документации, пакет docs-issue-* Выглядит нормально.
Не настал ли час?
Увы, пока нет. Впрочем, если есть готовое предложение что с ним сделать - сделаю. До того, чтобы покопаться с документацией самому, у меня пока что времени нет.
Час что-то делать настал :) Но я пока не придумал, что делать: * в багзилле есть дистрибутивы, туда и добавить трекинг документации * сделать отдельный продукт * что-то ещё. Для справки, текущие компоненты в продукте Docs: admin An Administrator's Guide from CVS alt ALT Linux specific documents books Published books devel Developer's Guide document-info Document-info files entities Entities for DocBok/XML files faqs Online F.A.Q. install Installation Guide persons Developers and overall contributors list user User's Guide xsl XSL styles for XSLT processing faq я сейчас оттащу в infrastructure, а что делать с остальными?
(In reply to comment #3) > Час что-то делать настал :) Но я пока не придумал, что делать: > * в багзилле есть дистрибутивы, туда и добавить трекинг документации IMHO для дистрибутивной это оптимально. > * сделать отдельный продукт Это может быть осмысленно при большом количестве недистрибутивной или той, которую затруднительно однозначно классифицировать в разрезе дистров. > faq я сейчас оттащу в infrastructure, а что делать с остальными? И назначь, наверное, на меня... хотя мож и тебя туда притащить? :)
Создан продукт "книжки" и компоненты "документация" в дистрибутивах. Нужен ли всё ещё отдельный продукт для документации?
(In reply to comment #5) > Создан продукт "книжки" и компоненты "документация" в дистрибутивах. > > Нужен ли всё ещё отдельный продукт для документации? Пожалуй, не нужен. Хорошо бы только, чтобы было вразумительное объяснение на видном месте в багзилле, как вешать багу на документацию. Выбор компонента docs для пользователя может оказаться довольно неочевиден. С другой стороны, если уточнение адреса ошибки будет работой специально обученных людей, то это не имеет большого значения.
Простая форма для загоняния багов - это https://bugzilla.altlinux.org/show_bug.cgi?id=16696, там и про документацию вспомнить придётся. А эту багу я тогда закрою.
