Друзья, с наступившим всех новым годом! Желаю всего хорошего в новом году!
У меня есть желание составить картину мира форматов и инструментов, которые используются в повседневной работе для создания документации. Интересует создание и обработка текста.  Уверен  это будет интересно и полезно всем присутствующим. Давайте посмотрим как обстоят дела. Будет удобно обрабатывать данные, если вы сопроводите сообщение тэгом, например #usedoc. Начну с себя.

Добро пожаловать :)
Инициатива хорошая.

Друзья, с наступившим всех новым годом! Желаю всего хорошего в новом году!
У меня есть желание составить картину мира форматов и инструментов, которые используются в повседневной работе для создания документации. Интересует создание и обработка текста.  Уверен  это будет интересно и полезно всем присутствующим. Давайте посмотрим как обстоят дела. Будет удобно обрабатывать данные, если вы сопроводите сообщение тэгом, например #usedoc. Начну с себя.

Я недавно рисовал mindmap всего, что я знаю про SSG. Может, оформлю и выложу.

#usedoc сейчас плотно на Sphinx+RST+plantuml+vale+redoc и chai для апи, в следующем году для нового проекта будем пробовать md+hugo+gitlab pages

Друзья, с наступившим всех новым годом! Желаю всего хорошего в новом году!
У меня есть желание составить картину мира форматов и инструментов, которые используются в повседневной работе для создания документации. Интересует создание и обработка текста.  Уверен  это будет интересно и полезно всем присутствующим. Давайте посмотрим как обстоят дела. Будет удобно обрабатывать данные, если вы сопроводите сообщение тэгом, например #usedoc. Начну с себя.

Так наверно проще обрабатывать будет

#usedoc Привет всем. Мы сейчас на Jekyll+md+vale+mermaid+mercurial

#usedoc Привет всем. Мы сейчас на Jekyll+md+vale+mermaid+mercurial

#usedoc
Ещё добавлю, вдруг пригодится:
Оптимизация изображений: image_optim
Валидация ссылок: htmlproofer

https://www.questionpro.com/t/PGhS9ZgCFE
вот здесь постоянно пополняемые результаты опроса тома джонсона для тех, кто пишет девелоперскую документацию. можно составить примерное представление, как оно там с тулами

#usedoc
Пользовательская документация
— Sphinx, reST, линтеры doc8, Sphinx+linkcheck, vale
— Jekyll, Md
— Swagger, redoc
— CI: Jenkins, работал ещё с Gitlab CI, немного Travis
— поиск у нас кастомный
— аналитика Google Analytics, фидбек в Typeform

Внутренняя документация
— Confluence, sphinxcontrib-confluencebuilder
— аналитика Matomo

— на своих проектах пробовал Hugo

#usedoc
Пользовательская документация
— Sphinx, reST, линтеры doc8, Sphinx+linkcheck, vale
— Jekyll, Md
— Swagger, redoc
— CI: Jenkins, работал ещё с Gitlab CI, немного Travis
— поиск у нас кастомный
— аналитика Google Analytics, фидбек в Typeform

Внутренняя документация
— Confluence, sphinxcontrib-confluencebuilder
— аналитика Matomo

— на своих проектах пробовал Hugo