В чем пишем пользовательскую документацию?

http://en.wikipedia.org/wiki/ReStructuredText

Markdown

пользователи != пограммисты

WYSIWYG?

Латех, ясен пень.

Если вопрос, в чем мы пишем, то тек. Если, в чем писать вендузятникам, однозначно в том, на чем умеют. Переучивание всегда сопряжено с потерей производительности и неразберихой

да, все было бы так просто еслиб не требовалось отслеживать изменения в том что они написали - а ворд это не позволяет

Ну вобще-то позволяет, рецензирование и все дела, в новых что-то еще добавили

Markdiwn + pandoc. Mediawiki. LaTeX, конечно, вне конкуренции.

Вообще-то позволяет в режиме совместной работы \ режиме правок.

Не уверен, что это будет эффективно при большой массовой коллективной правке, но глянь.

Мы так изменения в договорах отслеживаем. И вообще историю изменений.

muse

Нет, разметкой, которая совсем не рокет сайенс и запоминается за 5 минут.
А вот с интерактивными двухоконными (в одном разметка, в другом - результат) под онтопиком плохо, но при желании можно пользоваться этим.

там убого, обычный wiki в этом отношении гораздо навороченнее

Мы-то в ReST, а в чем буду ваши вендузятнеги - ХЗ.

Юзаем reStructuredText и Sphinx, а чтоб люди, владеющие навыками работы с ms word, не пугались, склепали к нему веб-редактировалку, подруженную с системой контроля версий, и сказали, что это вики.

иди в *опу со своим латексом, старый извращенец! либреофис рулит и педалит!

Нужно потом это прегонять в PDF и HTML, причем с разными стилями, а писать это должны люди владеющие навыками работы с ms word.

LibreOffice. Только обязательно проведи ликбез, как работать со стилями и не отбивать пробелами. :) Если все хорошо сделают, то потом можешь чесать репу насчет конвертации документов куда-нибудь еще. Можно сразу в PDF и HTML, а можно свой парсер сделать. Я, например, делал один раз на XSLT, потому что человек, который писал, мог так же только Word. А текстов много всяких. Я наколбасил быстренько преобразователь в нужный мне формат, взяв за основу какой-то чужой преобразователь и переделав его. Но это может и не понадобиться вообще.

Мы в docbook пишем, xml2po для переводов.

а чем пишете?

Ну у нас её программисты пишут, поэтому просто в IDE набиваем текст, я в geany, в основном, и в poedit русский перевод правлю.

retext. поддерживает markdown и rst.

в HTML c html-редактором

Пользователи-не-программисты пишут в rest гораздо проще чем в ворде.

Да в Либре, в чём ж ещё.

Asciidoc+fop

так то да, ну а, если вики и использовать?

В ворде/либре. Одно время пробовал евернот - его, в принципе, хватает для простеньких заметок в html, но у нас начальство требует бумажный вариант всех мануалов, оформленных по-вендузяццки, так что один болт - ворд/либра.

вот, но там фигово делать таблицы

Таблицы везде делать фигово.

LyX - и латех, и визуальный.

всё зависит от объема и кол-ва участников. Если кол-во одновременно участвующих в написании документации 1-3 то ворд самое то. Там есть и версии/правки и сравнение версий и т.д. просто надо выйти из моды - ворд убог и немного его изучить :).

Ну а так dokbook и svn :-). Ентерпрайз любит Author-it http://www.author-it.com/?page=documentation , но он вроде как не дешевый.

DocBook. Генерим PDF-ки dblatex-ом, пишем в Serna.

у серны цена...

Мы используем ту, которая Free и Open Source, правда, пришлось выскребать её из snapshot.debian.org