Skip to content

fix(sync): remove generated MDX trailing whitespace - #129

Merged
acedatacloud-dev merged 1 commit into
mainfrom
codex/terra-docs-whitespace-20261101
Nov 1, 2026
Merged

acedatacloud-dev merged 1 commit into
mainfrom
codex/terra-docs-whitespace-20261101

Conversation

@acedatacloud-dev

Copy link
Copy Markdown
Member

Summary

  • Keep Markdown hard breaks while removing accidental line-end spaces from generated MDX.
  • Strip trailing spaces inside fenced examples, which are rejected by the coordinator's git diff --check gate.
  • Add a regression test for prose hard breaks, single trailing spaces and fenced code.

Why

The GPT-6.1 Terra Docs coordinator produced a complete 3996-page report and passed MDX validation, then failed at Git's whitespace gate (git exited 2). The generated diff contained 176 trailing-whitespace diagnostics in translated Responses code examples; two newly translated guides had additional prose/list line-end spaces.

Validation

  • python3 -m compileall -q scripts tests && python3 -m unittest — 52 tests passed.
  • node --test tests/mdx-validation.test.mjs — 4 tests passed.
  • Read-only preview against current Backend 9f0013ca3867522e5bf9534bb9de3a49ec7068a6 — 3996/3996 translations current.
  • node scripts/validate_mdx.mjs /tmp/docs-terra-preview-whitespace-r2-20261101 — 4161/4161 pages valid.
  • Copied the complete preview into a clean Docs Git clone, staged 663 changed files, and ran git diff --cached --check HEAD — zero diagnostics.
  • git diff --check on this PR — passed.

Release

Merge this generator fix, then rerun the Backend Docs coordinator. It will regenerate the content PR from the current source and translations. Rollback is a normal revert of this generator change.

@acedatacloud-dev
acedatacloud-dev merged commit 11156b9 into main Nov 1, 2026
2 checks passed
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