Skip to content

docs(document): document json-placeholders conversion option and default placeholder protection - #463

Merged
yoshiamakino merged 2 commits into
mainfrom
docs/json-placeholders-option
Sep 30, 2026
Merged

yoshiamakino merged 2 commits into
mainfrom
docs/json-placeholders-option

Conversation

@yoshiamakino

Copy link
Copy Markdown
Contributor

Documents the JSON placeholder protection workstream now live on prod:

  • json-placeholders conversion option in the input_conversion_options reference (openapi.yaml, regenerated openapi.json): protect (default) keeps identifier-shaped placeholders such as {stars} verbatim; translate translates them. ICU MessageFormat skeletons are always protected with only branch text translated. Moves the pptx-only restriction onto the suppress-image-types bullet, since conversion options now apply to json too.
  • Changelog entry (September 30): default placeholder protection for json documents + the opt-out.
  • Best-practices JSON section: placeholder behaviour, the translate opt-out, ICU skeleton guarantees, and the two known caveats (branch text translated in isolation; missing plural categories fall back to other).

Behaviour verified live on prod 2026-09-29/30: default arm {stars} intact 5/5, ICU skeletons 6/6 intact on prod and api-test.

@mintlify

mintlify Bot commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
deepl-c950b784 🟢 Ready View Preview Sep 30, 2026, 9:40 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@yoshiamakino
yoshiamakino merged commit f291d45 into main Sep 30, 2026
3 checks passed
@yoshiamakino
yoshiamakino deleted the docs/json-placeholders-option branch September 30, 2026 09:41

This branch was successfully deployed

1 active deployment
staging — 4d5a97ad Deployed Sep 30, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant