+
Skip to content

Conversation

NWylynko
Copy link
Contributor

@NWylynko NWylynko commented Oct 9, 2025

This adds greater flexibility to our existing partials / includes

Adds support for partials to include other partials in them

If you have a partial that should build upon another partial, just <Include /> it

For example:

filename: ./docs/_partials/welcome.mdx

Welcome to the Clerk Docs

<Include src="_partials/getting-started" />

filename: ./docs/_partials/getting-started.mdx

To get started, install the clerk dependency

filename: ./docs/index.mdx

Clerk Docs

<Include src="_partials/welcome" />

Would output:

filename: ./dist/index.mdx

Clerk Docs

Welcome to the Clerk Docs

To get started, install the clerk dependency

Adds support for a _partials folder to exist anywhere in the docs

a _partials folder can now be put anywhere in the ./docs folder, wherever is most relevant to the guides that will be consuming the partial. The existing partials can still be included using src="_partial/ while relative will need to be src="./_partial/ or src="../_partial/

For example:

filename: ./docs/billing/_partials/setup.mdx

To create subscriptions open the clerk dashboard

filename: ./docs/billing/getting-started.mdx

<Include src="./_partials/getting-started" />

Would output:

filename: ./dist/billing/getting-started.mdx

To create subscriptions open the clerk dashboard

Example pr

Checkout #2693 to see how the relative partials can be used. That pr builds on top of this pr.

Checklist

  • I have clicked on "Files changed" and performed a thorough self-review
  • All existing checks pass

Copy link

vercel bot commented Oct 9, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Updated (UTC)
clerk-docs Ready Ready Preview Oct 10, 2025 1:19pm

@NWylynko NWylynko marked this pull request as ready for review October 10, 2025 11:01
@NWylynko NWylynko requested a review from a team as a code owner October 10, 2025 11:01
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

点击 这是indexloc提供的php浏览器服务,不要输入任何密码和下载