Этой статьей я начинаю серию публикаций, посвященных инструментам создания и ведения документации. Весь набор инструментов можно условно разделить на два типа: онлайн и оффлайн инструменты. К первому типу относятся сервисы, размещенные на вашем или стороннем сервере. Такая документация удобна тем, что создается и редактируется она удаленно и доступна сразу после сохранения всем пользователям. Примерами таких инструментов могут служить:
- Wiki-документация.
- Zendesk.
- Naturaldoc.
- Confluence.
Ко второму типу относятся программы и редакторы, устанавливаемые на компьютер техническому писателю. В результате их использования получается документ в одном из распространенных форматов: doc, pdf, chm и т.п. Для создания документации используются как классические редакторы вроде «MS Word», так и специализированные, например «Doc-o-Matic».
Здесь речь пойдет о создании документации в Wiki, а именно в её подвиде «DokuWiki». Читать далее «Создание документации в Wiki (часть 1)»