[docs] ВНИМАНИЕ: отчёт и насущные проблемы

[Andriy Dobrovol's'kii]

Anatoly Yakushin wrote:
 > Kirill Maslinsky пишет:
 >
 >> Добрый день!
 >>
 >> Прежде чем предлагать полиси, хотелось бы описать текущее состояние
 >> дел в проекте DOCS и его насущные потребности.
 >
 > <skip>
 >
 > Не утерпел и решил ввязатся :)
 > Ибо призыв Вадима так и остался гласом вопиющего!
 >
 > У нас опять все скатилось к количеству тегов в db и качеству 
верстки в
 > latex.
 >
 > Может я чего не понимаю, но...
 >
 > Работать, не имея целей, весьма затруднительно.
 > Насколько я понимаю, основной целью проекта docs@ является создание
 > отчуждаемой документации.
 > Отчуждаемой - в данном случае ключевое слово, т.к. создание и 
поддержка
 > встроенных систем помощи, man, info и т.д. в задачу проекта не 
входит.
 > Или входит? :)
 > Это вопрос номер раз.
 >
 > Вопрос номер два - основной целью проекта является создание 
электронной
 > документации обо всех аспектах функционирования Linux (ибо в 
Сизифе есть
 > большинство софта для этой ОС) или создание печатной документации 
для
 > дистрибутивов Альта?.
 > Задачи, согласитесь достаточно полярные, и решение обоих этих 
задач в
 > рамках одного проекта малореально, тогда лучше его разбить на два
 > подпроекта.
 >
 > И третий вопрос технологический (из него проистекает выбор 
инструмента)
 > - возможность обратного преобразования размеченного текста. 
Именно этот
 > вопрос и является камнем преткновения сегодня (это много раз 
обсуждалось).
 >
 > Очень бы хотелось услышать от руководителя проекта внятный ответ 
на эти
 > вопросы.
 >
 >
 >
О! Наконец-то это прозвучало. Я подумал, что это только мне кажется,
что снова "телегу запрягают перед лошадью". И, учитывая свое не
участие в проекте последнее время, решил воздержаться от коментариев.
Я полностью разделяю мнение, что рабочий процес и инструментарий
будут зависеть от четко определенных целей проекта и планируемых
методов её достижения.
Как пять копеек, несколько недооформившихся мыслей.
Мне кажется, что реальной целью проекта может стать: "Создание
силами сообщества максимально актуальной электронной версии
документации к Сизифу описывающей особенности применения этого
хранилища для решения реальных задач пользователей".
Как методы её достижения планируются:
Коллективная работа над содержанием и его представлениями с
использованием только средств доступных под GPL. Чтоб каждый
участник проекта мог вносить вклад на любом этапе создания конечного
продукта и при необходимости самостоятельно сгенерировать все
поддерживаемые представления продукта.
Результатом таких формулировок должно стать наличие постоянно
актуальной документации к Сизифу из которой уже в нужный момент с
минимальными правками возможно получение документации к очередному
дистрибутиву.
-- 
Rgrds,
Andriy
*********************************************************************
email: dobr at iop dot kiev dot ua            Kyiv, Ukraine
Phone: (380-44)   265-7824            Department of Gas Electronics
Fax:   (380-44)   265-2329             Institute of Physics of NASU
*********************************************************************