AI document processing

Your AI translation pipeline is losing context. Give every stage the same contract.

The glossary was uploaded. QA still changes the term back. Give every stage a shared contract for resources, context, validation and recovery.

On this page
  1. The glossary arrived. The meaning did not.
  2. Resolve once. Record what actually won.
  3. Give each chunk a job and a boundary.
  4. A second AI pass is another opinion.
  5. Retry the run you accepted.
  6. Questions we hear

The short version

  • Resolve conflicts before translation; sending more files does not create a shared policy.
  • Pin the source, resource contents, prompts, schemas and model settings to one run.
  • Keep neighboring text as read-only context, then validate every stage before saving its result.

The glossary arrived. The meaning did not.

The translation uses the right language and the wrong product term. QA changes it back. A retry changes it again. Your team uploaded the glossary, style guide and reference files. Why is the pipeline still arguing with itself?

Usually, the missing piece is an explicit agreement about which resources apply, what each stage receives, and which revision is being processed. The model sees the request you assembled, not the project your PM has in mind.

Consider a fictional payments app. “Charge” means taking a payment on one screen and a fee on another. A glossary alone cannot settle both. Build the context contract before improving the prompt.

Resolve once. Record what actually won.

For each job, resolve the customer, language pair, content type and approved resource set. Decide whether a project glossary replaces the default or merges with it. For a merge, define how conflicting entries are handled. Stop for an owner’s decision when two mandatory instructions cannot both be satisfied.

From uploaded resources to one accepted run
  1. Identify the job

    Bind source revision, customer, locale pair and intended use.

  2. Resolve the resources

    Select approved terminology, style and references; surface conflicts.

  3. Freeze the manifest

    Record resource hashes, prompt/schema versions and model settings.

  4. Accept this revision

    Changes create a new revision; retries keep the accepted contract.

A useful run manifest identifies the original file and its checksum; glossary and reference contents; prompt templates and code-owned instructions; output schema; model configuration; and segmentation rules. A configuration version without its resource contents is incomplete. A fingerprint of only the editable prompt misses instructions added by application code.

If the pipeline retrieves translation-memory examples, filter by permitted customer, locale, approval status and revision before selecting relevant entries. Record which examples were used. Never treat an uploaded TMX file as proof that retrieval is implemented.

Give each chunk a job and a boundary.

Segmentation defines the units of translation. Batching groups those units into a model request. Keep document, unit and segment identities intact across both; XLIFF defines these separately. See the XLIFF specification.

Send the current segments, relevant terminology and enough neighboring source text to resolve meaning. Label neighbors read-only and require output only for the requested IDs. For UI strings, use tagged screenshots and notes tied to the relevant string. Review source changes before reusing translations or approvals; an unexplained reference folder is not a context policy.

Budget the complete request: instructions, schema, terms, references, source and response allowance. Reduce optional neighbors or split the batch before dropping mandatory constraints. Define what every stage receives; style instructions used only in postediting will not shape the initial translation.

A second AI pass is another opinion.

The guarded path from source to delivery
  1. Translate selected segments

    Use the pinned contract and preserve protected markers.

  2. Validate the result

    Check IDs, coverage, placeholders, tags and applicable terminology rules.

  3. Review meaning

    Review all eligible segments; verify proposed corrections against evidence.

  4. Approve and round-trip

    Apply the agreed human gate and test the exported revision.

Reject missing, duplicated or unexpected segment IDs before advancing. Check nonempty targets and protected placeholders in code. Terminology checks need a declared policy for inflections and context-sensitive alternatives. Passing these checks proves structural compliance, not linguistic correctness.

Reviewing only the first reviewer’s flagged segments can reduce work, but cannot find errors that reviewer missed. Use independent human checks on representative output and track missed errors alongside false alarms. Keep AI-complete and human-approved as separate states.

Retry the run you accepted.

Save a validated chunk and its completion checkpoint in one transaction. On resume, retain completed work and retry only unresolved units under the same manifest. A resource change starts a new revision; it must not silently alter the remaining half of a document.

Keep source, translated, reviewed and delivered revisions distinct. Before export, verify that the file contains the intended current targets and review state. Preserve the file skeleton and prove an unchanged round trip before trusting edited exports. The handoff checklist covers that boundary.

Before the pipeline receives another file
  • One accepted manifest identifies source, resource contents and stage contracts.
  • Resource conflicts have an explicit resolution or block processing.
  • Requested IDs are distinct from read-only context.
  • Every stage validates before its result and checkpoint commit.
  • Retries preserve the manifest; delivery follows the agreed approval policy.
Download this checklist (PDF)

Questions we hear

Should every request receive the full glossary?

Use relevant approved entries, while preserving mandatory constraints. Sending everything consumes budget and can add conflicting meanings.

Does more context always improve translation?

No. Irrelevant or stale references compete with the task. Select context by meaning, permission, locale and revision.

Can two AI reviewers replace human approval?

Two passes can share blind spots. Set approval policy by content risk and evaluate missed errors on independently reviewed examples.

Sources

  1. XLIFF Version 2.1OASIS
  2. Screenshots and string contextCrowdin documentation
  3. Source text review and changed translationsCrowdin documentation
Written by the SeriusTech engineering team

We build custom software, business systems, applied AI and localization technology for growing businesses. Implementation notes describe work our engineers contributed to; researched guides cite sources and distinguish recommendations and illustrative examples from observed results. Products and clients stay unnamed.

Localization & LSP technology servicesFollow for new field notes
Free 30-minute discovery call

Want this solved in your business?

  1. Send a short request. We reply within 1 business day with times that suit your time zone.
  2. Talk it through for 30 minutes, free and with no obligation.
  3. Leave with a suggested first step, such as a fixed-price discovery sprint.
Free, 30 minutes, no obligation

Request your discovery call

Tell us a little about your project. We reply within 1 business day with times that suit your time zone.

Open email draft

This opens your email app with a draft to contact@seriustech.com. Nothing is sent until you send it.