Skip to content

Restore API identifiers reverted by the locadex sync in #1394 - #1406

Open
Chadha93 wants to merge 1 commit into
mainfrom
fix/restore-api-literals-in-locales
Open

Restore API identifiers reverted by the locadex sync in #1394#1406
Chadha93 wants to merge 1 commit into
mainfrom
fix/restore-api-literals-in-locales

Conversation

@Chadha93

Copy link
Copy Markdown
Member

Why every PR is failing the "Locale literals" check

The Keep API literals untranslated step has failed on every pull request since 2026-09-08. Timeline:

  1. Run the docs checks in CI and add a runnable-samples lint #1380 (9a8730a4) added scripts/check-locale-api-literals.sh and wired it into CI, and restored translated identifiers in the localized trees.
  2. Keep API identifiers in English in localized prose #1393 (5b710116) extended the check to prose and restored the remaining ones: changeTracking (translated as seguimientoDeCambios, suiviDesModifications, rastreioDeMudanças), crawl.started (rastreo.iniciado) and the sample variable scrapedData (dadosRaspados).
  3. docs(locadex): update translations on main #1394 (d7054044, locadex-agent[bot], merged 07:26 the same day) was an automated translation sync. It rewrote exactly the 14 pages Keep API identifiers in English in localized prose #1393 had fixed, plus one pt-BR OpenAPI description, from Locadex's translation memory, which still held the translated identifiers. Its own "Locale literals" check was FAILURE and it merged anyway.

Root cause: #1380 and #1393 edited the localized files directly but did not change what Locadex stores as the translation (neither touched gt-lock.json, and the memory lives in the General Translation service). The next sync treated the manual edits as drift and restored its cached output.

What this PR does

Reverses the .mdx and pt-BR/api-reference/v1-openapi.json hunks of #1394 one-for-one, returning the 15 files to their #1393 state. sh scripts/check-locale-api-literals.sh passes locally on this branch. gt-lock.json is left untouched.

The repo's CLAUDE.md says not to edit localized files by hand; this PR does so deliberately because the check that is blocking every other PR guards exactly these files, and the previous fix was applied the same way.

What still needs to happen outside this repo

This will be reverted again by the next Locadex sync unless one of these is done in the General Translation dashboard:

  • add changeTracking, crawl.started and scrapedData (and ideally every enum value and property name from the OpenAPI specs) as do-not-translate glossary terms, or
  • retranslate the affected strings there so the translation memory matches these pages.

It is also worth making the "Locale literals and extraction-hostile markdown" check required so an automated sync cannot merge over it, since #1394 merged with it failing.

🤖 Generated with Claude Code

#1393 restored changeTracking, crawl.started and scrapedData in the
Spanish, French and Portuguese pages, and added the CI check that keeps
API identifiers in English. Hours later the automated translation sync
in #1394 rewrote the same 14 pages from Locadex's translation memory,
which still held seguimientoDeCambios, suiviDesModifications,
rastreioDeMudanças, rastreo.iniciado and dadosRaspados, and merged with
that check failing. Every pull request since has failed the check.

This reverses the .mdx and pt-BR OpenAPI hunks of #1394 exactly, which
brings the pages back to the #1393 state. scripts/check-locale-api-literals.sh
passes again.

The translation memory is unchanged by this commit, so the next Locadex
sync will reintroduce the same strings unless the terms are pinned as
do-not-translate in the General Translation dashboard or the affected
strings are retranslated there.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Sep 11, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated
firecrawl 🟢 Ready View Preview Sep 11, 2026, 2:50 PM

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

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