На чём документацию пишите?

LaTEX для документации которая идет пользователю
Markdown — для внутренней документации проекта.

oXygen XML Editor является одним из лучших XML-редакторов, предоставляющий полный набор средств разработки XML для публикации выходных документов в форматы PDF, HTML, EPUB. Редактор подхватывает пространства имен, прописанные в метаданных документа, и, согласно им, максимально облегчает пользователю работу с текстом (в том числе в визуальном режиме) - автоматически формирует список доступных элементов и список атрибутов к ним для быстрой вставки, реализует автодополнение кода, проверяет корректность кода, строит иерархическое дерево документа, позволяет схлопывать и раскрывать участки кода. Редактор имеет встроенные сценарии преобразований XSL→FO→PDF и XSL→HTML, включая XSLT, которые предназначены для обработки содержимого файлов, созданных по технологии DocBook или DITA, с предоставлением возможности кастомизировать стили, применяемые к тэгам форматирования и структурирования.
В чем наиболее важные преимущества XML редакторов на основе технологии подобных DoocBook, перед WYSIWYG редактором типа MS Word:

• Принцип единого источника. Документ в Oxygen можно собирать из "кирпичиков" - из разных текстов, хранящихся в других файлах. В результирующем файле будут ссылки для вставки определенного куска текста из определенного файла.
• Профилирование. Блоки данных можно помечать специальными атрибутами, которые отвечают за публикацию документа в той или иной интерпретации.
• Отделение оформления от содержания. Писатель работает только с содержанием и разметкой.

vim

на ворде

Ручкой на листочке

на доске