[docs] семинар по документации в офисе
Kirill Maslinsky
kirill на altlinux.ru
Чт Фев 3 10:37:39 MSK 2005
Господа!
В пятницу, 4 февраля поутру (часов этак с 10) в офисе ALT
пройдёт семинар по документации.
Прошу пожаловать всех заинтересованных!
Программа:
Название: "ALT Linux Docs -- проект открытого репозитория документов".
* Предполагаемый documentation workflow и роли:
- Куча / Документы / Автор
- Сизиф / Модули / Сопровождающий
- Багзилла / Модули / Редактор + ответственный редактор
- Издание / Книги+эКниги / Выпускающий
* Что и почему _не_ входит в ALD
- Man-ы и внутрипакетная документация (за исключением б.м. ссылок на)
- Тексты, которые нельзя прокрутить через WorkFlow
- ...
* Технические недоделки (aka фронт работ)
- Куча-check и Куча-HTTP
- Проблема зависимостей (пакеты ставить не нужно, но нужно, чтобы
были, притом определённых версий)
- Проблема ALD-формата (зачем нужен, какими свойствами должен
обладать, почему то, что сейчас есть -- не он)
* Как на этой базе
- Выпускать дистрибутив
- Выпускать журнал
- Вычитывать несоответствия
- Делать книжки
- Взаимодействовать со сторонними проектами
- FAQ
- KnB им. тов. Шигорина
- ...
--
Kirill Maslinsky
ALT Linux Documentation Team
Подробная информация о списке рассылки docs