[docs] Политики, цели, задачи...

Anatoly Yakushin doc на iqchoice.com
Чт Янв 13 14:38:24 MSK 2005


Всех приветствую!

Мы вчера с Гергием при поддержке smi и некоторых нскоро 
пойманных участников TEAM попробовали провести brainstorm по 
обсуждаемым вопросам.

Излагаю то, что получилось в сухом остатке (Георгий 
дополнит, если я что-то пропустил).

ПО итогам достаточно бурного обсуждения можно попробовать 
сформулировать цели создаваемого проекта.

AltLinux Docs Team (в дальнейшем ADT) - открытый 
общественный проект, ставящий своей целью  создание и 
поддержание в актуальном состоянии свободной документации по 
программам  репозитария Sysiphus и решениям на его основе.
В рамках проекта предполагается решение следующих задач:
1. Мониторинг потребностей в свободной документации.
2. Адаптация имеющихся и создание новых инструментов для 
поддержания полного жизненного цикла репозитория документации.
3. Улучшение имеющихся и создание новых документов, 
поддержание репозитория свободных документов.
4. Взаимодействие с работающими под свободными лицензиями 
техническими писателями и нахождение новых участников 
проекта, организация взаимодействия между техническими 
писателями  и свободными разработчиками.
5. Взаимодействие с существующими учебными и методическими 
организациями, заинтересованными в наличии свободной 
документации.
6. Выпуск регулярного периодического издания.


Теперь примечания :) :

Если первые пять пунктов не должны вызвать особых 
возражений, IMHO мы это все обсудили, то пункт 6 требует 
пояснений. Мноие могут возразить, что "нафига нам 
периодическое издание". Попробую объяснить -- если проводить 
аналогию с Сизифом, а она напрашивается сама собой, то в 
документационном репозитории отсутствует собственно "момент 
истины", т.е. потребность в постоянном обновлении.
Выпуски документации к дистриутивам ситуации не спасают, так 
как случаются достаточно редко.
Для того, чтобы избежать возможности "застоя", наладить 
обратную связь с пользователями обязательно необходимо 
подобное периодическое издание (в настоящее время видимо 
электронное). Кстати, идея о таком издании носится в 
воздухе, вспомните хотя бы инициативу, возникшую в community 
по этому поводу.

На этом предлагаю подвести черту и поделить, кто его будет 
делать, ибо понятно, что один Кирилл от такого объема работ 
станет скучный :)


-- 
Rgrds,
Anatoly A. Yakushin aka DOC
Orthopaedic Departmens
Veterans Hospital # 3
Moscow


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