[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