add-docs-page

To add a Docusaurus documentation page safely, you must configure the frontmatter, ensure correct sidebar positioning via filesystem-based autogeneration, and implement relative cross-linking to prevent build-time errors and broken links.

Docusaurus throws a build error when onBrokenLinks is set to 'throw' and new markdown pages lack valid relative cross-linking. You must ensure all internal links resolve correctly before the local build completes.

The best way to organize technical writing categories in Docusaurus is by leveraging filesystem-based autogeneration for sidebars, which eliminates manual configuration and maintains consistent sidebar ordering across the documentation site.

Configuring frontmatter and sidebar ordering requires following standardized rules for category indexing and page positioning within the docs-site directory, ensuring the technical manual maintains site integrity and consistent navigation.

Yes, filesystem-based sidebar autogeneration works without manual configuration in Docusaurus, allowing you to add new documentation pages and categories by simply placing files in the correct directory structure.

Yes, you can and must use relative cross-linking to prevent broken links in a Docusaurus manual, ensuring compliance with build-time constraints like onBrokenLinks: 'throw' during local verification procedures.