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

Michael Shigorin mike на osdn.org.ua
Чт Янв 13 12:34:50 MSK 2005


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

Это разные стадии с разной целью и разными качествами обычно.

Гляньте любые предметно-ориентированные и непосредственно
пригодные к употреблению статьи на atmsk.altlinux.org.ua и
прикиньте, врисовываются ли они *непосредственно* в документацию
выпуска.

-- 
 ---- WBR, Michael Shigorin <mike на altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/


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