Skip to content

Keep excerpt locations traceable after text transformations

Preserve the basis of local offsets when formatting changes an evidence excerpt.

Guides

Keep excerpt locations traceable after text transformations — what should the operator record?

A character offset recorded against one text representation may point to the wrong passage after line-ending changes, normalization or redaction. Keep excerpt locations tied to the exact permitted representation they describe. Do not present a locally calculated position as an original source timestamp or a service-supplied citation feature.

Practical operations check
Preserve the basis of local offsets when formatting changes an evidence excerpt.
Use text_revision, offset_unit, start_offset and end_offset in the local excerpt index. State whether positions count code points, bytes or another defined unit, since these differ for non-ASCII content and can shift differently during export.
State which text revision the positions address and how unresolved locations are represented. An exact local character span supports artifact navigation, not a guarantee that the publisher's live page has identical formatting or unchanged wording.
01 / Guides

Name the offset basis

Use text_revision, offset_unit, start_offset and end_offset in the local excerpt index. State whether positions count code points, bytes or another defined unit, since these differ for non-ASCII content and can shift differently during export.

02 / Guides

Preserve the unaltered reference

Where permitted, retain a restricted reference to the exact text representation used for indexing. If only a derived representation remains, mark its offsets local-to-derived rather than implying they can locate the same passage in every source view.

03 / Guides

Test a transformation edge

Use labeled fixture text containing a line break and accented characters. Apply the actual display transformation and check whether the old offsets still recover the intended passage; if not, create a new offset index tied to the new representation.

04 / Guides

Review redacted passages

When content must be withheld, remove prohibited text and invalidate affected offsets as policy requires. Do not preserve the old passage inside an offset diagnostic merely to keep a technical pointer reproducible after the underlying content can no longer be retained.

05 / Guides

Publish a bounded index

State which text revision the positions address and how unresolved locations are represented. An exact local character span supports artifact navigation, not a guarantee that the publisher's live page has identical formatting or unchanged wording.

Keep the boundaries clear.

  • Preserve the basis of local offsets when formatting changes an evidence excerpt.
  • Operational record: Name the offset basis. Context badges do not certify access.

Start with a read-only check: ask your agent to report actual source coverage before collecting records or exporting an audience.

Primary references

Documentation reviewed 2026-11-15. Product capabilities, client availability and plans can change. Third-party marks identify their products, not an affiliation.

Know what social media shows about you.
Start with a question.

Get started
montage