[docs] Re: требования к формату модуля документации

Vitaly Ostanin vyt на vzljot.ru
Ср Янв 12 00:21:12 MSK 2005


Alexandre Prokoudine пишет:
> Vitaly Ostanin пишет:
> 
>>Kirill Maslinsky пишет:
>>
>>
>>>Ещё раз всем привет. Продолжение.
>>>Требования к разметке модуля DOCS =================================
>>>
>>>DocBook не очень годится в качестве формата для модуля документации в 
>>>DOCS: он слишком велик (около 400 элементов), требует долгого и 
>>>внимательного изучения. Кроме того, многие полагают разметку в XML 
>>>неудобной.
>>>Задача: разработать (или выбрать) формат, в котором
>>>будет вся необходимая и достаточная логическая информация для сборки 
>>>конечных форматов.
>>>Постулат: такой формат может и должен содержать не более 7--12 элементов.
>>
>>Блажен кто верует :) Вы, конечно, можете попробовать, но это 100% 
>>очередной велосипед.
> 
> Кстати, интересно твоё мнение: Simplified DocBook -- это тоже велосипед?

Нет, это ПЕАР :) Удобно ведь думать, что "нас заставляют!!", хотя 
на самом деле брать можно только те теги, которые реально 
занадобились, благо стили их понимают. Стили, кстати, одни и те 
же для всего DocBook, и для упрощённого.

Но чтобы не заставляли, мы возьмём чуть-чуть тегов и объявим 
независимость :) IMHO, это просто психологический ход - 
кастрированный DocBook, не пугающий количеством возможностей.

> http://www.docbook.org/specs/wd-docbook-simple-1.1CR2.html

PS Ресурсов мало, инструментов мало, но мы придумали выход! Мы 
придумаем свой формат :) Это не сарказм, это просто смешно :)

<skipped/>

-- 
Regards, Vyt
mailto:  vyt at vzljot.ru
JID:     vyt at vzljot.ru
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 256 bytes
Desc: OpenPGP digital signature
Url : http://lists.altlinux.ru/pipermail/docs/attachments/20050112/02397d92/signature.bin


Подробная информация о списке рассылки docs