[docs] M24 docs impressions

Yura Zotov yz на altlinux.ru
Чт Дек 9 00:11:52 MSK 2004


On Wed, Dec 08, 2004 at 06:22:26PM +0300, Kirill Maslinsky wrote:
> Добрый день.
> 
> > Отчасти эта проблема решается публикацией roadmap по подготовке
> > документации к конкретным выпускам. Поскольку без такой
> > информации совершенно неясно: надо ли сейчас срочно доводить
> > документ до ума или можно подождать или вообще поезд уже ушёл. И
> > обязательно публиковать список исходных файлов, текст из которых
> > планируется в релизе. 
> 
> Именно так. Но почему только к выпускам? Наверное, ещё более 
> правильным будет публикация списка всех имеющихся в docs@
> текстов, с указанием их статуса? Здесь же можно отразить 
> согласие автора поддерживать документ (если таковое имеется), 
> или сообщение о том, что его никто не поддерживает (orphaned). 
> Указать сведения о (не)адекватности текста, если таковые имеются. 
> Отдельным полем указать, в какие выпуски планируется включить
> данный документ, если планируется. И куда он уже включён.
> 
> Короче говоря, речь идёт о создании базы данных по всем документам
> docs@, с возможностью публичного доступа на чтение к такой базе, 
> в идеале -- через web. Вопрос в том, как это организовать технически.
> 
> > С моей точки зрения, сейчас самой большой проблемой проекта docs@
> > является полное отсутствие публичности. То есть непонятно кто что
> > делает, зачем и к когда.
> 
> Согласен. Попробуем эту проблему решить.

У меня есть предложение присваивать всем авторским текстам рейтинг
от 0 до 9. 0 -- без этого текста ни один дистрибутив не может быть
выпущен. 1 -- важно для всех дистрибутивов, 2  -- важно для
мастера, 3-9 всякие спецдистрибутивы (примерно). Первоначально рейтинг 
присваивает автор, окончательно "главный документалист ALT Linux". 
По этому рейтингу сразу видно, что и в каком порядке надо править, 
читать, издавать... Для волонтёров тоже понятно, где их труд будет
более всего востребован. 


--
Юрий А. Зотов



Подробная информация о списке рассылки docs