В чем оформлять документацию? Опции

[ataradov]

У многих крупных фирм, где выпускается множество документации, эта самая документация оформлена в едином стиле. Так вот может знает кто, что именно они используют?

И что можно порекомендовать использовать для это цели? ТеХ это конечно здорово, но проблемы с таблицами и необходимость все долго затачивать убавляют оптимизм. Желательно что-нибудь работающее из коробки и с простым синтаксисом типа как в wiki.

[Doka]

У многих крупных фирм, где выпускается множество документации, эта самая документация оформлена в едином стиле. Так вот может знает кто, что именно они используют? И что можно порекомендовать использовать для это цели? ТеХ это конечно здорово...

используется принцип разделения содержания текста от того как он будет представлен (аналог таблицы стилей (CCS) для HTML).
В мире технической документации для этого используются специальные стандарты. Мне наиболее продвинутым и прогрессивным показался DocBook.
а ТеХ это совсем не здорово, а вчерашний день. Если сегодня начинать работать с написанием тех.документации, то разумнее остановить свой выбор на _стандарте_ , основанном на XML, как наиболее универсальном и продвинутом языке структурированной разметки текстов.

И что можно порекомендовать использовать для это цели? ТеХ это конечно здорово, но проблемы с таблицами и необходимость все долго затачивать убавляют оптимизм. Желательно что-нибудь работающее из коробки и с простым синтаксисом типа как в wiki.

если с простым синтаксисом как в Вики - то и возъмите, например, MoinMoin Wiki Engine - там присутствует возможность хранения текстов в формате того же DocBook.


ссылки для lazyusers:
* WikiPedia o MoinMoin
* WikiPedia o DocBook