[devel] О документации

[Vladislav Zavjalov]

On Fri, Feb 04, 2011 at 05:34:04PM +0600, REAL wrote:
> 04.02.2011 17:06, Андрей Черепанов пишет:
> >В последнее время в join пришло много новых людей, им
> >нужна понятная документация.
> 
> Хотелось бы видеть хотя бы статистику по join, а то вот лично я вижу 
> только, как уходят. Как приходят - не вижу, а жаль.

Я вот пытался рисовать красивые картинки про активность мантейнеров
со временем (просто по записям в changelog'ах существующих пакетов).
Никакого ужаса там, кстати, не наблюдается, если не думать про конкретных
людей (а это субъективно и на картинках не отражается).
Думаю, статистика приходов - это тем более не показатель. Скорее уж
интересно понимать, кто есть в данный момент, в каком состоянии, чем
занимается...

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

Слава