[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