[docs] Политики, цели, задачи...
Vadim Vinichenko
vnv на 14000.ru
Чт Янв 13 12:33:47 MSK 2005
Kirill Maslinsky wrote:
> Добрый день!
>
>
>>Ещё раз -- давайте разделим:
>>
>>- официальную документацию выпусков (бумага плюс байтики);
>>- онлайновую документацию, относящуюся к выпускам;
>>- Sisyphus (байтики only).
>
>
> Давайте соотнесём это с идеей документировать решения.
> Представьте себе документ, например, "Как сделать почтовый сервер".
> Для определённого среза Сизифа, всех сделанных на основе этого
> среза дистрибутивов и соответсвующего онлайн-периода это будет
> один и тот же текст. Так может быть лучше объединять усилия
> работающих над его улучшением людей, а не разделять их?
Да, наверное, так логичнее. Если продолжать аналогию с Сизифом, на
основе которого желающие выпекают решения исходя из своих потребностей,
то разница между официальной документацией "под бумагу", электронной
документаций к дистрибутиву и т.д. возникает скорее не на уровне
составления и сопровождения пула документации, а на уровне изготовления
на основе этого пула конкретного "документационного решения" - например,
документации к конкретному дистрибутиву или учебному курсу. Подобно
тому, как составитель решения, основанного на Сизифе, решает, что и куда
ему взять.
Хотя, конечно, у изготовителя конкретных решений могут возникать
пожелания к исходному пулу - это вполне естественно, и такие пожелания
заслуживают внимания.
--
С уважением,
Вадим
Подробная информация о списке рассылки docs