Обо мне
Меня зовут Дунаевский Максим, и я работаю техническим писателем в ПАО Группа Астра, а точнее — ООО «РусБИТех».
Образование
У меня дипломы бакалавра и магистра, выданные Липецким Государственным Техническим Университетом:
- 2005 — 2009: бакалавр техники и технологии
- 2010 — 2011: магистр техники и технологии
Стаж работы
Здесь только стаж работы техническим писателем:
- 2020 — 2022: Documentat.io, технический писатель
- 2022 — настоящее время: ООО «РусБИТех», технический писатель
Инструменты
GNU Emacs
Мой основной инструмент — GNU Emacs. В нём я пишу код, книги и вообще почти все тексты. Этот README тоже создан в GNU Emacs. А ещё я веду Telegram-канал GNU Emacs для технических писателей, где пишу про настройки, пакеты и проблемы GNU Emacs.
Docs as Code
Мне нравится подход Docs as Code, когда документация хранится в системе контроля версий и сразу видно, кто когда и какую правку сделал.
Для Docs as Code я использую Git в связке с GitFlic, GitHub и BitBucket.
AsciiDoc
Мне нравится AsciiDoc — он отлично подходит для написания книг.
Sphinx
Я использую Sphinx в работе каждый день. С его помощью созданы вот эти порталы документации:
Markdown
В моей жизни был большой период, когда я использовал разметку Markdown. Она хорошо подходит для несложной вёрстки. Однако, для чего-то более-менее сложного нужно использовать что-то другое. AsciiDoc отлично подходит!
Confluence
Мне не нравится Confluence, но я умею с ним работать.