[docs] Политики, цели, задачи...

Vadim Vinichenko vnv на 14000.ru
Чт Янв 13 12:33:47 MSK 2005


Kirill Maslinsky wrote:
> Добрый день!
> 
> 
>>Ещё раз -- давайте разделим:
>>
>>- официальную документацию выпусков (бумага плюс байтики);
>>- онлайновую документацию, относящуюся к выпускам;
>>- Sisyphus (байтики only).
> 
> 
> Давайте соотнесём это с идеей документировать решения. 
> Представьте себе документ, например, "Как сделать почтовый сервер".
> Для определённого среза Сизифа, всех сделанных на основе этого
> среза дистрибутивов и соответсвующего онлайн-периода это будет 
> один и тот же текст. Так может быть лучше объединять усилия
> работающих над его улучшением людей, а не разделять их?

Да, наверное, так логичнее. Если продолжать аналогию с Сизифом, на 
основе которого желающие выпекают решения исходя из своих потребностей, 
то разница между официальной документацией "под бумагу", электронной 
документаций к дистрибутиву и т.д. возникает скорее не на уровне 
составления и сопровождения пула документации, а на уровне изготовления 
на основе этого пула конкретного "документационного решения" - например, 
документации к конкретному дистрибутиву или учебному курсу. Подобно 
тому, как составитель решения, основанного на Сизифе, решает, что и куда 
ему взять.

Хотя, конечно, у изготовителя конкретных решений могут возникать 
пожелания к исходному пулу - это вполне естественно, и такие пожелания 
заслуживают внимания.

-- 
С уважением,
Вадим



Подробная информация о списке рассылки docs