14249 2008-01-30 17:34:40 +0300 ревизия компонента Docs 2008-12-10 18:29:19 +0300 1 1 2 Infrastructure Infrastructure bugzilla.altlinux.org unspecified all Linux CLOSED FIXED P2 normal --- 1 kirill dottedmag mike dottedmag oldest_to_newest 62306 0 kirill 2008-01-30 17:34:40 +0300 KM> Есть компонент Docs, по факту много лет неиспользуемый и отражающий KM> ныне не существующую структуру документации. По идее, его нужно KM> почистить от неактуальных ошибок и упразднить. Это обязательно (можно почистить, упразднить и создать новый). KM> Либо наполнить новым содержанием. Мне представляется осмысленным в KM> разделе "Документация" в багзилле использовать двухуровневую KM> структуру: Дистрибутив (с конкретной версией) / Руководство (в KM> одном дистрибутиве может быть по нескольку руководств) KM> Руководство соответствует в нашей терминологии выпуску KM> документации, пакет docs-issue-* Выглядит нормально. 67075 1 kirill 2008-03-31 13:45:18 +0400 Не настал ли час? 67080 2 dottedmag 2008-03-31 13:52:21 +0400 Увы, пока нет. Впрочем, если есть готовое предложение что с ним сделать - сделаю. До того, чтобы покопаться с документацией самому, у меня пока что времени нет. 72871 3 dottedmag 2008-06-20 16:04:57 +0400 Час что-то делать настал :) Но я пока не придумал, что делать: * в багзилле есть дистрибутивы, туда и добавить трекинг документации * сделать отдельный продукт * что-то ещё. Для справки, текущие компоненты в продукте 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, а что делать с остальными? 73005 4 mike 2008-06-22 22:15:02 +0400 (In reply to comment #3) > Час что-то делать настал :) Но я пока не придумал, что делать: > * в багзилле есть дистрибутивы, туда и добавить трекинг документации IMHO для дистрибутивной это оптимально. > * сделать отдельный продукт Это может быть осмысленно при большом количестве недистрибутивной или той, которую затруднительно однозначно классифицировать в разрезе дистров. > faq я сейчас оттащу в infrastructure, а что делать с остальными? И назначь, наверное, на меня... хотя мож и тебя туда притащить? :) 82561 5 dottedmag 2008-12-10 17:07:56 +0300 Создан продукт "книжки" и компоненты "документация" в дистрибутивах. Нужен ли всё ещё отдельный продукт для документации? 82576 6 kirill 2008-12-10 17:40:42 +0300 (In reply to comment #5) > Создан продукт "книжки" и компоненты "документация" в дистрибутивах. > > Нужен ли всё ещё отдельный продукт для документации? Пожалуй, не нужен. Хорошо бы только, чтобы было вразумительное объяснение на видном месте в багзилле, как вешать багу на документацию. Выбор компонента docs для пользователя может оказаться довольно неочевиден. С другой стороны, если уточнение адреса ошибки будет работой специально обученных людей, то это не имеет большого значения. 82578 7 dottedmag 2008-12-10 18:29:19 +0300 Простая форма для загоняния багов - это https://bugzilla.altlinux.org/show_bug.cgi?id=16696, там и про документацию вспомнить придётся. А эту багу я тогда закрою.