[devel] q: [[git.alt]] с применением gear-*/girar-* (was: [newbies] путь пакета в сизиф)

[Денис Смирнов]

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
----------------------------------------------------------------------------
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://lists.altlinux.org/pipermail/devel/attachments/20100127/4c76bd90/attachment-0001.bin>