Size: a a a

technicalwriters

2021 July 26

NV

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

FM

Fox Mulder in technicalwriters
Я просто не исследовал данный вопрос, может и есть.
источник

rK

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

NV

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

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

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

V

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

NV

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

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

rK

rJIynbIu` KOT in technicalwriters
спасибо, понял
источник

FM

Fox Mulder in technicalwriters
Crowdin понимает adoc
источник

ET

Eduard Tibet in technicalwriters
Поиском в гитхабе по лейблам doc, help needed
источник
2021 July 27

AG

Anna Gasparyan in technicalwriters
#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/). По всем вакансиям можно писать мне в личку
источник

ME

Maria Ermakovich in technicalwriters
вау)
источник

АД

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

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

НО

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

АД

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

НО

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

АД

Анастасия Дахина... in technicalwriters
ну это да
источник

ДЧ

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

ДЧ

Дарья Чернавина... in technicalwriters
А JTBD — это про пользу.
источник

AG

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

ДЧ

Дарья Чернавина... in technicalwriters
+
источник