[docs] docs plans

[Michael Shigorin]

On Wed, Dec 24, 2003 at 04:33:09PM +0300, Alexandre Prokoudine wrote:
> Антон предлагает писать документацию так, чтобы она не была
> завязана на конкретное приложение.

Это хорошо, но расходится с "эффективным применением" и "справкой
по аргументам".  В принципе.

2 rider: если ты _это_ имел в виду -- догадаться было невозможно.

> Однако, таким образом мы получим документацию алгоритма, т.е.
> чистую теорию вместо практики, в то время как решение задач
> подразумевает в гораздо большей степени практику.  Разумность
> такого подхода представляется мне сомнительной.

Это раз.  И два -- он подразумевает универсализацию, а это
процесс сложный и дорогой.

> Программы должны быть документированы в первую очередь сами по
> себе теми, кто в этом заинтересован. Ресурсов ALT на всеобщее
> документирование не хватит никогда.

Именно.  И тратить силы на дублирование -- самоубийство.

-- 
 ---- WBR, Michael Shigorin <mike на altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20031224/7e092d0c/attachment.bin