[docs] Re: документация для нового Junior'а

[Alex Ott]

Привет

>>>>> "KM" == Kirill Maslinsky writes:
 KM> Именно к этому я и клонил, признаться. Я недавно начал работать с
 KM> документацией, и поэтому только составляю для себя список задач, которые
 KM> специфичны именно для документации ALT и не реализованы ни в DocBook, ни
 KM> где-либо еще, так, как именно бы хотелось.  И тут у меня есть все шансы
 KM> наступать на старые грабли и бродить известными путями, поэтому прошу
 KM> всех давних участников меня предупреждать от ошибок и ссылать в архив 
 KM> рассылки, особенно буду благодарен за ссылки конкретные. 

 KM> Что же касается автоматизации, то ее логично основывать на максимально 
 KM> выверенной и локализованной под специфику ALT разметке, но пока в тех 
 KM> текстах, которые я видел, -- увы! -- все очень и очень вразнобой. 
 KM> А местами принцип логической разметки явно не соблюдается, например,
 KM> <emphasis>GNU General Public License</emphasis> -- ?
 KM> Но это еще частность... Отсюда, мне кажется, многие проблемы с 
 KM> плохим качеством при конвертации в другие форматы.

это неправильно, это надо вынести как entity

 KM> Скажите пожалуйста, где, кроме alt-entities есть специфические для 
 KM> ALT элементы разметки? (чтобы ничего не упустить из того, что уже 
 KM> сделано)

Я вот думаю, а нужно ли определять собственные теги для названий
дистрибутивов и т.п.? я у себя на работе использую entities и потом при
профайлинге подставляется нужный. Это позволяет в работе использовать
стандартные инструменты разметки - например, чтобы не дописывать .rnc для
docbook - может это неправильно и от лени, но это работает :-)

-- 
With best wishes, Alex Ott
-------------------------------
Jet Infosystems, Moscow, Russia    mailto: ottalex на narod.ru
http://xtalk.msk.su/~ott/          ICQ #22005116