[docs] M24 docs impressions

[Kirill Maslinsky]

Добрый день.

> Отчасти эта проблема решается публикацией roadmap по подготовке
> документации к конкретным выпускам. Поскольку без такой
> информации совершенно неясно: надо ли сейчас срочно доводить
> документ до ума или можно подождать или вообще поезд уже ушёл. И
> обязательно публиковать список исходных файлов, текст из которых
> планируется в релизе. 

Именно так. Но почему только к выпускам? Наверное, ещё более 
правильным будет публикация списка всех имеющихся в docs@
текстов, с указанием их статуса? Здесь же можно отразить 
согласие автора поддерживать документ (если таковое имеется), 
или сообщение о том, что его никто не поддерживает (orphaned). 
Указать сведения о (не)адекватности текста, если таковые имеются. 
Отдельным полем указать, в какие выпуски планируется включить
данный документ, если планируется. И куда он уже включён.

Короче говоря, речь идёт о создании базы данных по всем документам
docs@, с возможностью публичного доступа на чтение к такой базе, 
в идеале -- через web. Вопрос в том, как это организовать технически.

> С моей точки зрения, сейчас самой большой проблемой проекта docs@
> является полное отсутствие публичности. То есть непонятно кто что
> делает, зачем и к когда.

Согласен. Попробуем эту проблему решить.

-- 
Kirill Maslinsky
ALT Linux Team * Documentation Project