Какой дополнительный список необходимо включить в сжатый пакет при передаче результатов перевода коллегам?

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

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

Нужно ли прикреплять контрольный список при доставке сжатого пакета? Вывод в одно предложение

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

##Записывайте факты в список, не пишите расплывчатые оценки

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

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

Создание и просмотр составного списка доставки

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

import hashlib
import json

def sha(raw):
    return hashlib.sha256(raw).hexdigest()

source = b"synthetic source"
output = b"synthetic translated output"
manifest = {
    "manifest_version": 1,
    "job_id": "demo-job-001",
    "source_sha256": sha(source),
    "output_sha256": sha(output),
    "target_language": "en",
    "policy_version": "demo-v1",
    "checks": {"file_present": True, "human_review": "pending"},
    "open_issues": ["Review terminology on the example cover"]
}
encoded = json.dumps(manifest, ensure_ascii=False, sort_keys=True)
restored = json.loads(encoded)
assert restored["source_sha256"] == sha(source)
assert restored["output_sha256"] == sha(output)
assert restored["checks"]["human_review"] == "pending"
assert restored["output_sha256"] != sha(output + b"changed")
assert not {"token", "password", "api_key"} & restored.keys()

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

Как манифест служит получателю

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

📊 Сравнение ядра

Манифесты и файлы должны иметь общие версии

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

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

Упростите обработку результатов перевода

После загрузки перевода с OmniDoc (портал продуктов) команда может создать этот список на своем собственном уровне доставки, записывая исходный файл, язык и статус проверки. Это не требует от платформы внедрения какой-либо внутренней технологии, а просто добавляет контекст, необходимый для совместной работы за пределами документа, упрощая доставку и проверку результатов.

Источники: Python json.

🎯 Какой метод подходит вам?

Если в сжатом пакете несколько переводов

Прикрепите список с указанием исходных файлов, соответствующих каждому переводу.

Если вам нужно, чтобы несколько человек разделили работу на проверку

Запишите проверку машины и проверку человеком отдельно в контрольном списке и укажите целевой язык.

Если перевод обновлен

Повторно создайте манифест и поместите его в тот же каталог версии, что и файл новой версии.

Если вы отвечаете за процесс доставки команды

Создайте манифест на своем собственном уровне доставки для записи исходных файлов, языков и статуса проверки.

❓ Часто задаваемые вопросы (FAQ)

1. Можно ли прямо в списке написать "очень хорошее качество"?

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

2. В списке видно, что проверка пройдена. Означает ли это, что все правильно?

нет. Осмотр машины и проверка вручную должны записываться отдельно.passed: true не означает, что все содержимое верно.

3. Можно ли поместить в список весь объект запроса?

Не рекомендуется. Следует использовать явные белые списки полей, а также проверять вложенные структуры и текстовые комментарии.

4. После обновления перевода можно ли продолжать использовать старый список?

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

📝 Резюме

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

Загрузите OmniDoc Desktop бесплатно: документы, таблицы, презентации и PDF-файлы — все в одном месте