[web] spec-и

[Kirill Maslinsky]

On Thu, Dec 04, 2008 at 03:29:26PM +0600, Mikhail Gusarov wrote:
> Twas brillig at 12:14:12 04.12.2008 UTC+03 when kirill на altlinux.org did gyre and gimble:
> 
>  KM> наверняка будет исключительно полезен для хорошо понимающих RPM --
>  KM> как справочник (в общем, как man).
> 
> Так и задумывалось.
> 
>  KM> Но вот для новичков и технически неподготовленных людей он скорее будет 
>  KM> путать и отпугивать сложностью, чем помогать. Думаю, тут нужно попробовать
>  KM> найти другие принципы структурирования информации и построения навигации.
> 
> Нужно просто написать другую доку.
Ещё нужно, чтобы попадая на altlinux.org/RPM пользователь видел как раз эту 
другую доку в первую очередь, а не справочник по макросам.

>  KM> Кстати, раз справочник по полям и макросам спека похож на man, то,
>  KM> возможно, его более правильное место -- в пакете RPM в качестве
>  KM> документации?
> 
> Гммм. Разумная мысль. И документацию на спецмакросы - складывать в
> соответствующие пакеты.

Вдогонку: в идеале сделать тонкую обёртку под названием rpmdoc
с функциями, аналогичными perldoc, pydoc и т.п.

Usage: rpmdoc '%setup'

А каждый пакет, приносящий с собой rpm-макросы, обязать в полиси
провайдить доку, которая бы встраивалась в эту систему.

-- 
Kirill Maslinsky
ALT Linux Team
----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Url     : <http://lists.altlinux.org/pipermail/web-team/attachments/20081204/bfb1c9fc/attachment.bin>