Skip to content

docs: fix broken code examples#1960

Merged
caio-pizzol merged 13 commits intomainfrom
caio/sd-1570-fix-broken-code-examples
Feb 6, 2026
Merged

docs: fix broken code examples#1960
caio-pizzol merged 13 commits intomainfrom
caio/sd-1570-fix-broken-code-examples

Conversation

@caio-pizzol
Copy link
Contributor

No description provided.

- field-annotation.mdx: replace non-existent @superdoc/field-annotation
  with SuperDoc constructor pattern
- typescript-migration.mdx: @core/Extension → superdoc/super-editor
- document-section.mdx: superdoc/extensions → superdoc/super-editor
- template-builder quickstart + intro: superdoc/dist/style.css → superdoc/style.css
Wrap all fragment code snippets in superdoc/methods.mdx and
supereditor/methods.mdx with CodeGroup Usage + Full Example tabs
so every snippet is self-contained and runnable.
Adds scripts/validate-code-imports.js that scans all MDX files for
JS/TS code blocks and validates import paths against an allowlist.
Run with `pnpm run check:imports` from apps/docs.
@linear
Copy link

linear bot commented Feb 6, 2026

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 880a0f9375

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Wrap every code fragment across 36 extension doc pages with
CodeGroup Usage/Full Example tabs so snippets are copy-pasteable.
Extracts "Full Example" code blocks from MDX files using remark/unified
AST parsing, transforms them to run headlessly, and executes them against
a real Editor instance to catch stale API references.

Also fixes doc bugs caught by the tests:
- overview.mdx: acceptAllChanges → acceptAllTrackedChanges
- structured-content.mdx: add missing helper namespace
Replace regex state machine with remark-parse + remark-mdx AST walking.
Convert from CJS to TypeScript, run with bun instead of node.
Add lefthook pre-commit hooks (docs-check-imports, docs-test-examples)
that run when MDX files are staged. Update docs-validation CI workflow
with import checking and doctest steps.
@caio-pizzol caio-pizzol merged commit 396eaf0 into main Feb 6, 2026
7 checks passed
@caio-pizzol caio-pizzol deleted the caio/sd-1570-fix-broken-code-examples branch February 6, 2026 21:03
@superdoc-bot
Copy link

superdoc-bot bot commented Feb 6, 2026

🎉 This PR is included in superdoc v1.11.0-next.23

The release is available on GitHub release

@superdoc-bot
Copy link

superdoc-bot bot commented Feb 6, 2026

🎉 This PR is included in superdoc v1.12.0-next.1

The release is available on GitHub release

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant