Bug 14249

Summary: ревизия компонента Docs
Product: Infrastructure Reporter: kirill <kirill>
Component: bugzilla.altlinux.orgAssignee: Mikhail Gusarov <dottedmag>
Status: CLOSED FIXED QA Contact: Mikhail Gusarov <dottedmag>
Severity: normal    
Priority: P2 CC: mike
Version: unspecified   
Hardware: all   
OS: Linux   

Description kirill 2008-01-30 17:34:40 MSK 
KM> Есть компонент Docs, по факту много лет неиспользуемый и отражающий
 KM> ныне не существующую структуру документации. По идее, его нужно
 KM> почистить от неактуальных ошибок и упразднить.

Это обязательно (можно почистить, упразднить и создать новый).

 KM> Либо наполнить новым содержанием. Мне представляется осмысленным в
 KM> разделе "Документация" в багзилле использовать двухуровневую
 KM> структуру: Дистрибутив (с конкретной версией) / Руководство (в
 KM> одном дистрибутиве может быть по нескольку руководств)

 KM> Руководство соответствует в нашей терминологии выпуску
 KM> документации, пакет docs-issue-*

Выглядит нормально.
Comment 1 kirill 2008-03-31 13:45:18 MSD 
Не настал ли час?
Comment 2 Mikhail Gusarov 2008-03-31 13:52:21 MSD 
Увы, пока нет. Впрочем, если есть готовое предложение что с ним сделать - 
сделаю. До того, чтобы покопаться с документацией самому, у меня пока что 
времени нет.
Comment 3 Mikhail Gusarov 2008-06-20 16:04:57 MSD 
Час что-то делать настал :) Но я пока не придумал, что делать:

* в багзилле есть дистрибутивы, туда и добавить трекинг документации
* сделать отдельный продукт
* что-то ещё.

Для справки, текущие компоненты в продукте 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, а что делать с остальными?
Comment 4 Michael Shigorin 2008-06-22 22:15:02 MSD 
(In reply to comment #3)
> Час что-то делать настал :) Но я пока не придумал, что делать:
> * в багзилле есть дистрибутивы, туда и добавить трекинг документации
IMHO для дистрибутивной это оптимально.

> * сделать отдельный продукт
Это может быть осмысленно при большом количестве недистрибутивной или той, которую затруднительно однозначно классифицировать в разрезе дистров.

> faq я сейчас оттащу в infrastructure, а что делать с остальными?
И назначь, наверное, на меня... хотя мож и тебя туда притащить? :)
Comment 5 Mikhail Gusarov 2008-12-10 17:07:56 MSK 
Создан продукт "книжки" и компоненты "документация" в дистрибутивах.

Нужен ли всё ещё отдельный продукт для документации?
Comment 6 kirill 2008-12-10 17:40:42 MSK 
(In reply to comment #5)
> Создан продукт "книжки" и компоненты "документация" в дистрибутивах.
> 
> Нужен ли всё ещё отдельный продукт для документации?
Пожалуй, не нужен. Хорошо бы только, чтобы было вразумительное объяснение
на видном месте в багзилле, как вешать багу на документацию. 
Выбор компонента docs для пользователя может оказаться довольно неочевиден.
С другой стороны, если уточнение адреса ошибки будет работой специально
обученных людей, то это не имеет большого значения.
Comment 7 Mikhail Gusarov 2008-12-10 18:29:19 MSK 
Простая форма для загоняния багов - это https://bugzilla.altlinux.org/show_bug.cgi?id=16696, там и про документацию вспомнить придётся.

А эту багу я тогда закрою.