Для тебя да, а тут в постановке задачи есть локализация. Потому и уточняю.

Я просто не исследовал данный вопрос, может и есть.

а разве Antora+adoc не практически полный аналог Sphinx+rST? какие там вообще переводы и локализация предусмотрены, я думал и там и там самому надо сторонними сервисами обрабатывать исходники документации для создания CAT-системы, локализовывать, а потом уже переведённый документ использовать в качестве альтернативной версии документации

Ключевое требование — чтобы движок мог вытащить строки в файлы для перевода, а потом из переведенных файлов собрать документацию.

В Sphinx локализация из коробки отличная, он выгружает строки в формат GNU Gettext (.po) и потом собирает доки локализованные. Только нужен инструмент для перевода (CAT, computer-assisted translation), мы вот Crowdin используем.

В Анторе я в прошлый раз (года два назад) не нашёл такую фичу, но вдруг завезли уже.

Товарищи, какие опенсорсные проекты можете посоветовать, чтобы поконтрибьютить доку на английском для портфолио и опыта?

Либо нужен сторонний инструмент, который умеет работать с разметкой и из неё выделять файлы на перевод. Не знаю, есть ли такой для разметки AsciiDoc. Для Markdown точно есть.

Последний вариант — прямо так закинуть файлы в CAT, перевести и обратно скачать. Так будет сложнее отслеживать изменения, и наверняка придется написать какой-нибудь скрипт, чтобы проект собирать с двумя комплектами файлов. Но в целом реально, если есть ресурсы на разработку.

спасибо, понял

Crowdin понимает adoc

Поиском в гитхабе по лейблам doc, help needed

#wanted_tw В компании JetBrains открыты вакансии технического писателя сразу в нескольких продуктах: DataGrip (небольшой продукт, супер-уютная команда: https://www.jetbrains.com/careers/jobs/technical-writer-549/), IntelliJ IDEA (флагманский продукт, челленджинг задачи, связанные не только с написанием документации, и супер-профессиональная и поддерживающая  команда тех-писателей с замечательным тимлидом: https://www.jetbrains.com/careers/jobs/technical-writer-491/), Qodana (новый продукт для статического анализа и мониторинга качество кода, который только выходит на рынок: https://www.jetbrains.com/careers/jobs/technical-writer-qodana-652/) и новый продукт, который мы разрабатываем для технических писателей (тут вообще уникальная возможность участвовать в разработке продукта "для себя" и быть не "second class citizen", как часто случается с тех писателями, а непосредственно влиять на продукт и задавать стандарт для качества документации: https://www.jetbrains.com/careers/jobs/senior-technical-writer-new-product-670/). По всем вакансиям можно писать мне в личку

вау)

Сейчас читала у Ильяхова статью "Закисание мозгов и как его предотвратить" и он предложил своеобразную молитву. Думаю нам всем стоит ее иногда повторять:

"Нет клиента, кроме читателя. Нет пользы другой, кроме пользы ему. Всё важное читателю да скажется в заголовке, всё неважное да останется в черновиках вовеки веков. Да не будет он обманут, да не будет растрачено внимание его, да возрадуется читатель от полезного действия, да нажмет перст его главную продающую кнопку. Ибо клиент мой читатель, и нет клиента кроме него."

Про главную продающую кнопку - это не к нам. Это к "писателям продающих текстов". К нам - исключительно за пользой.

Это смотря с какой стороны посмотреть. Хорошая информация о продукте на сайте это тоже продающий текст. И не важно руководства, статьи, видео или реклама какая-то. Бывает и на стыке

Если цель - именно продать, то это точно не к техписам. Ильяхов сильно заточен именно на продажи. Техпичы все-таки, в первую очередь, про пользу.

ну это да

Если брать концепцию JTBD, то она хорошо работает и в маркетинге, и в аналитике, и, наверное, в техписательстве.

А JTBD — это про пользу.

+100500. Кстати, Ильяхов проводил у нас в комании года 3 назад 4-дневный тренинг для команды техписов - было супер-полезно для всех команды - появилось намного больше осознанности и не приходится теперь "отжимать воду" из документации

+