[devel] policy and tutorials

[Kirill Maslinsky]

On Fri, Mar 14, 2008 at 01:07:02AM +0300, Dmitry V. Levin wrote:
> On Fri, Mar 14, 2008 at 03:59:30AM +0600, Mikhail Gusarov wrote:
> > Twas brillig at 23:51:18 13.03.2008 UTC+03 when Dmitry V. Levin did gyre and gimble:
> > 
> >  >> Нужно лушче отразить основные понятия.
> > 
> > [.]
> > 
> >  DVL> Это будет очень полезная статья, но не правила упаковки разделяемых
> >  DVL> библиотек.
> > 
> > +1, ссылка на dsohowto будет куда полезнее и уместнее, чем пересказ.
> 
> Ссылки на dsohowto будет недостаточно, краткий рассказ с рецептами,
> наверное, тоже не помешает.  Но это не policy.

На практике ситуация прихода в команду означает, что у приходящего 
есть два очень насущных вопроса: не только "Как?" (ответ на него -- задача полиси),
но и "Почему/Зачем?" (ответ на это -- задача, HOWTO, рецептов, в общем
учебника). 

Мне кажется, было бы очень хорошим тоном, если бы в каждом из
наших полиси нулевым пунктом стояла ссылка на соответствующий такой 
HOWTO/учебник с растолкованием основных понятий и рецептов в той области, 
к которой относится полиси. Лучше всего, если такой учебник будет также 
составлен нами, хотя это, наверное, и не обязательно. 

Потому что люди очень часто приходят в команду учиться, осознают они
это, или нет. И лучше, если команда также будет это осознавать, и предлагать
им сразу в наших "учебниках" наше видение соответствующий проблемных 
областей. Чтобы потом дядьки не жаловались на то "какой безграмотный
пошёл мантейнер" и чтобы потом не приходилось "переучивать".

--
Kirill Maslinsky
ALT Linux Team