Разбор проблем перевода из Jira

Получайте предложения для движков на основе отзывов в задачах Jira с метками, проверяйте каждое изменение и выбирайте, какой подключённый контент перевести заново.

В задачах о проблемах перевода часто описывают то, что видно на экране: неверный термин продукта, кнопку на английском в переведённом интерфейсе или текст, который больше не помещается. Подключите Jira, чтобы собирать такие отзывы в разделе Очередь. Там вы сможете проверять предложенные изменения глоссария, правил и тональности бренда для выбранных движков.

В меню Studio 2.5 откройте Интеграции в разделе Studio 2.5, а не в разделе Настройки. Прежние ссылки для подключения и настройки по-прежнему работают.

Для каждого предложения выберите Применить или Отклонить. После применения изменений откройте вкладку Перевести заново в карточке задачи и решите, какой подключённый контент сгенерировать повторно.

Подключите Jira и опишите проблему #

Интеграция поддерживает Jira Cloud, в том числе Jira Service Management Cloud, и доступна на плане Enterprise. Актуальную информацию о доступности смотрите на странице тарифов.

  1. Откройте Настройки в разделе Очередь нужной организации Lingo.dev.
  2. В подразделе Источники Triage выберите Подключить и предоставьте доступ к сайту Jira через Atlassian OAuth. Управлять подключениями учётной записи вы можете в подразделе Интеграции раздела Настройки.
  3. Вернитесь в настройки раздела «Очередь» и выберите Выбрать движки для сайта. Укажите движки локализации, в которые можно вносить изменения на основе задач этого сайта, затем выберите Сохранить.

Чтобы по задачам сайта появлялись предложения, выберите для него хотя бы один движок. После сохранения выбора система также обработает уже открытые задачи с меткой lingo. Сайт может быть подключён только к одной организации одновременно. Комментарии в Jira публикуются от имени учётной записи, предоставившей доступ. Если команде нужно публиковать их от общего имени, используйте подходящую общую учётную запись.

Для подключения сайта, выбора движков и повторного перевода требуется org:manage_integrations. Чтобы применить или отклонить предложение, требуется org:suggestion:edit вместе с правом редактировать движок либо явно предоставленный участнику организации доступ к этому движку. О том, как предоставить доступ, читайте в разделе Права на работу с предложениями.

Добавьте в задачу всё, что нужно для разбора проблемы:

  • Затронутую локаль, точный исходный текст и отображаемый перевод, а также их расположение или ревизию.
  • Ожидаемый результат и саму проблему. Если она связана с отображением, приложите снимок экрана или укажите, сколько места доступно для текста.
  • Приложение или движок локализации, к которому относится проблема, а также уже утверждённые решения по терминологии.

Например: «В checkout для es-MX исходный текст кнопки — "Place order", но в ревизии X отображаемый перевод остаётся на английском». Такое описание указывает на конкретный непереведённый фрагмент, но не предполагает заранее, что для исправления нужна запись в глоссарии.

Добавьте к открытой задаче метку lingo — регистр не важен. Lingo.dev прочитает её заголовок, описание и комментарии и предложит изменения для выбранных движков сайта. Откройте раздел Очередь, в фильтре Тип выберите Triage и откройте карточку задачи, чтобы проверить предложения.

Обновления задачи с меткой тоже могут добавить её в раздел «Очередь». Если карточка задачи уже открыта, текущий набор предложений сохранится.

Проверьте, решает ли предложение описанную проблему #

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

Описанная проблемаЧто нужно выяснить
Неверный термин продукта на одном языкеКакой термин нужен, для какой пары локалей и в глоссарии какого движка локализации его нужно изменить.
Неожиданный формат даты на корейскомЭто переведённый текст или значение, которое форматирует приложение.
Немецкий текст не помещается в элемент навигацииМожно ли сократить текст без потери смысла, чтобы он поместился по ширине, или нужно изменить вёрстку компонента.
Для нескольких языков отображается исходный текстБыли ли переводы сгенерированы, загружены и выбраны для каждой локали.
Запросы к API возвращают код 429Связана ли проблема вообще с формулировкой перевода, а не с лимитом API.

Если отсутствует каталог переводов или проблема связана с форматированием даты либо вёрсткой, передайте её ответственным за приложение. Меняйте глоссарий, правило или тональность бренда, когда это решает описанную в задаче проблему с формулировкой.

Примените или отклоните каждое предложение #

Откройте вкладку Предложения в карточке задачи. Для каждого предложения проверьте движок локализации, язык, пояснение и ресурс, в который попадёт изменение. Предложения могут:

  • Добавлять или обновлять термин глоссария.
  • Добавлять или обновлять правило перевода.
  • Добавлять или обновлять вариант тональности бренда.

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

Когда генерация завершится и по всем предложениям в карточке задачи будут приняты решения, Lingo.dev опубликует в Jira комментарий с итогами и ссылкой на раздел «Очередь». Если ни один движок не предложит изменений, это тоже будет указано в комментарии. Проверьте результат и закройте задачу в Jira по принятому в команде процессу.

Решите, нужно ли обновлять существующие переводы #

После применения предложения откройте вкладку Перевести заново в карточке задачи. На ней перечислены затронутые интеграции GitHub, Zendesk и Payload CMS, а также целевые локали, которых касаются изменения.

Выберите интеграции для обновления, проверьте указанные для них локали и выберите Перевести заново. Для каждой выбранной интеграции будет заново переведён весь настроенный объём контента для этих локалей. Это может заменить уже принятые ручные правки. Расход на перевод учитывается как обычно.

Следите за каждым запуском и проверяйте результат там, куда он сохраняется: изменения в репозитории или пул-реквест для GitHub, переведённый контент и статус публикации в Zendesk или Payload. Проверьте результат, затем выполните слияние или опубликуйте контент по обычному процессу. Вы можете отложить повторный перевод — применённые указания сохранятся.

Восстановите или завершите разбор #

Если убрать метку lingo, закрыть или удалить задачу, её заявка в Очереди закроется. Предложения, ожидающие рассмотрения, будут отклонены, если на них не ссылается ни одна другая открытая заявка. Применённые изменения сохранятся. Если заново открыть задачу с этой меткой или вернуть метку открытой задаче после закрытия её заявки, начнётся новый раунд предложений. Вся предыдущая история сохранится.

Если ожидаемая карточка не появилась, проверьте, что задача открыта, у неё есть метка lingo, а сайт подключён и для него выбраны движки в подразделе Настройки раздела Очередь. Проверьте план организации и статус подключения. Если после восстановления доступа карточка всё ещё находится в обработке, отправьте ссылку на неё в поддержку Lingo.dev.

Управляйте авторизацией учётной записи и отключением в подразделе Интеграции раздела Настройки. Чтобы по новым задачам больше не появлялись предложения, но подключение сохранилось, снимите выбор всех движков в подразделе Настройки раздела Очередь и сохраните изменения. Существующие задачи завершите отдельно в Jira.

Вебхуки Jira продлеваются по расписанию. Если обновления перестали поступать, проверьте авторизацию сайта и состояние подключения. Если нужно восстановить доступ, подключитесь заново. Чтобы прекратить доступ у провайдера, отдельно отзовите разрешение OAuth. Существующие комментарии, применённые указания и готовые переводы сохранятся.