Bug 14249 - ревизия компонента Docs
: ревизия компонента Docs
Status: CLOSED FIXED
: Infrastructure
(All bugs in Infrastructure/bugzilla.altlinux.org)
: unspecified
: all Linux
: P2 normal
Assigned To:
:
:
:
:
:
  Show dependency tree
 
Reported: 2008-01-30 17:34 by
Modified: 2008-12-10 18:29 (History)


Attachments


Note

You need to log in before you can comment on or make changes to this bug.


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

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

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

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

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

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

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

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

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

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

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