[web] spec-и

[Aleksey Avdeev]

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-макросы, обязать в полиси
> провайдить доку, которая бы встраивалась в эту систему.

   И в нашем случаи -- русскоязычную доку.

-- 

С уважением. Алексей.


----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : signature.asc
Тип     : application/pgp-signature
Размер  : 552 байтов
Описание: OpenPGP digital signature
Url     : <http://lists.altlinux.org/pipermail/web-team/attachments/20081204/2f8d80d8/attachment.bin>