Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Require Docusaurus-friendly section index pages #500

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

ptgott
Copy link
Contributor

@ptgott ptgott commented Oct 22, 2024

If a directory has no section index page within it that is named after the directory, e.g., dir1/dir2/dir2.mdx, throw an exception when building the docs.

Currently, the docs engine also allows a section index page at the same level as its corresponding directory, since this is a convention the docs content has followed. However, this leads to undesired output when building the site with Docusaurus.

If a directory has no section index page within it that is named after
the directory, e.g., `dir1/dir2/dir2.mdx`, throw an exception when
building the docs.

Currently, the docs engine also allows a section index page at the same
level as its corresponding directory, since this is a convention the
docs content has followed. However, this leads to undesired output when
building the site with Docusaurus.
@ptgott ptgott requested a review from avatus as a code owner October 22, 2024 13:34
Copy link

vercel bot commented Oct 22, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
docs ❌ Failed (Inspect) Oct 22, 2024 1:37pm

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.

2 participants