[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