[docs] требования к формату модуля документации

Michael Shigorin mike на osdn.org.ua
Ср Янв 12 15:09:45 MSK 2005


On Wed, Jan 12, 2005 at 01:48:58PM +0300, Kirill Maslinsky wrote:
> Наверное, даже незачем их переучивать: пусть лучше пишут больше
> ;)

В контексте замечания про бумагу -- пусть лучше пишут _лучше_.
Overdocumentation -- тоже болезнь, ведь мера -- время.

> Ещё раз повторюсь: а зачем авторам учить какой-либо формат? Его
> должны знать _сопровождающие модулей_, а авторы должны легко
> его _читать_ и вносить правку (прочтя кратчайшее руководство).

+1

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


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