Я попробовал поставить на винде и как-то неудачно )

Я дико извиняюсь, но тут околопрофессиональная шуточка всплыла. Не могу не поделиться. Возможно, боян.

- что общего у бомжей и девопсов?
- роются в контейнерах

@Nick_Volynkin точно знает. Из значимых фич там вроде возможен мультисорс из нескольких гит-репозиториев

а в остальном она выглядит менее mature, чем тот же сфинкс (в терминах изкоробочных фич и экосистемы плагинов)

Исследовал её немного. Там главная фича вроде бы в том, что она может во время сборки перебирать ветки Git и из них собирать мультиверсионную документацию. Но имхо это плохая практика, потому что увеличивает время сборки. Неясно, зачем каждый раз пересобирать все версии (вдруг у меня их 10), если можно собирать по одной.

Совсем непонятно было, что у Анторы с поддержкой локализации. В доке ни слова про это. Без локализации она мне вообще неинтересна.

что-то тема подутихла! закинешь свои соображения по этому поводу?

пока мысли - брать техписов и выращивать из них, у кого будет интерес роста в эту сторону. до этого времени равномерно у всех прокачивать DocOps-компетенции

А как обучаете гиту?

ну как, берем и обучаем) еще даем почитать https://git-scm.com/book/ru/v2

Есть еще такая обучалка на нескольких языках: https://githowto.com/

Есть ещё вот такая штука про Git для тех, кто переходит на него с Hg, например: https://ohshitgit.com/

Я пробовал ради интереса. По-моему, порог вхождения высоковат по сравнению с другими, более распространенным ssg. И его преимущества (предположим, asciidoc и работа с версиями) не перевешивают этого. Тот же Docusaurus более дружелюбен и проще. Возможности локализации отсутствуют от слова совсем. Может это как-то можно организовать через дополнительные гит-репозитории и селектор для разных языков. Нас, например, не интересует версионность, и мы не работаем с гитом, поэтому ... Продукт ещё сыроват, но разработчики вроде активно там шевелятся. Из интересных док-сайтов на Анторе могу выделить https://docs.mulesoft.com/general/ и https://docs.couchbase.com/home/index.html. И ещё, вот автор описывает вкратце недостатки и позитив Анторы, и сравнивает с другими тулзами - https://evaparish.com/blog/2018/10/19/in-which-i-vent-more-about-antora

Если вы в Беларуси и вам интересна документация — присоединяйтесь :)

Привет! Хочу устроить техрайтерский чятик в Беларуси — Write The Docs Минск. Когда наберем достаточно местных, сможем собраться на митап, кофе, другие напитки.
Добро пожаловать: https://t.me/wtd_minsk

Мы перешли на Антору с гитбука. Пока ещё публично не выкатили, но, все работает просто шикарно

Как зачем переводить комментарии в примерах кода? Чтобы вот такие вот угарные примеры получались!
https://t.me/tech_b0lt_Genona/1130

@rusdacent отличная находка ))

Сам тащусь =))