On Wed, Jan 27, 2010 at 12:39:42PM +0200, Michael Shigorin wrote:

MS> - упоминать только высокоуровневые утилиты, описывая их
MS>   функциональность и отправляя в ман-страницы либо исходники
MS>   за деталями (но там не всегда обозримо);
MS>   + pro: более краткие и читабельные страницы
MS>   + contra: отдаление от понимания происходящего

Не согласен. Отсылать к man-страницам из wiki это плохо. Идеальная
документация состоит из справочника (man сраницы), и собственно
документации -- tutorial и HOWTO, которые легче поддерживать на wiki.

MS> - переименовать текущую страницу в "техническое руководство",
MS>   а в качестве "краткого руководства" описать утилиты.
MS>   + pro: документированность высокого и низкого уровня
MS>   + contra: ?

Предлагаю выделить страничку HOWTO с рецептами, а также сделать tutorial
-- отдельно по git, отдельно по git.alt.

-- 
С уважением, Денис

http://freesource.info
----------------------------------------------------------------------------