[docs] principal discussion

[Stanislav Ievlev]

On Mon, Jun 09, 2003 at 06:02:42PM +0400, Alexandre Prokoudine wrote:
> Greetings,
> 
> Беру на себя смелость поднять принципиальный вопрос о технологии
> подготовки нашей документации.
> 
> Накопленный опыт показывает, что текущая технология получения
> печатной документации не вполне себя оправдывает ввиду фактической
> невозможности нормальной обработки XSL-FO до получения красивой
> конкурентоспособной документации.
> 
> Давайте признаем, что заставить красиво выглядеть текст, созданный в
> LaTeX, гораздо проще, чем текст, созданный в DocBook/XML.
> 
Приехали. Столько усилий было потрачено на DocBook.
> Учитывая это, у нас есть три сценария дальнейшего развития событий.
> 
> Сценарий первый: оставить всё как есть. Совершенствовать текущие
> стили, ждать появления свободного редактора XSL-FO...
> Плюсы: меньше трудозатрат
> Минусы: неудовлетворительное качество оформления книжек
> 
> Сценарий второй. Держать документацию в DocBook/XML, создавать
> общий DB/XML для книжки, преобразовывать его в документ с
> разметкой LaTeX при помощи dblatex и довёрстывать уже в LaTeX.
> Плюсы: хорошее качество оформления книжек
> Минусы: высокие трудозатраты
> 
> Сценарий третий: Полностью перейти на LaTeX с использованием
> dblatex. Плюсы: хорошее качество оформления книжек
> Минусы: невозможность такой же модульной сборки, как в случае с
> DB/XML; очень высокие трудозатраты
Этот сценарий вряд-ли годится. Нам нужна и хорошая html документация.
Сомневаюсь, что из TeX это легко сделать.

Наверное наилучший - второй сценарий.

P.S. Любопытно: А как поступают в данной ситуации другие вендоры? Как они делают документацию?

> 
> Ваши мнения, коллеги?
> 
> -- 
> Alexandre Prokoudine
> ALT Linux Documentation Team
> JabberID: avp на altlinux.org