3pp-mirror/docusaurus
1
0
Fork 0
mirror of https://github.com/facebook/docusaurus.git synced 2025-07-17 16:47:56 +02:00
Code Issues Projects Releases Packages Wiki Activity

docs: Update website/docs/guides/docs/docs-create-doc.mdx

Browse source 
This clarification helps users understand the implications of using the `id` frontmatter and prevents confusion regarding document paths.
This commit is contained in:
Maria Stellini 2025-07-12 15:34:51 +02:00
parent 0306d18240
commit 45faa4a44b
1 changed files with 3 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

3
website/docs/guides/docs/docs-create-doc.mdx
View file

@ -190,3 +190,6 @@ Lorem ipsum
When using [autogenerated sidebars](./sidebar/autogenerated.mdx), the file structure will determine the sidebar structure. When using [autogenerated sidebars](./sidebar/autogenerated.mdx), the file structure will determine the sidebar structure.
Our recommendation for file system organization is: make your file system mirror the sidebar structure (so you don't need to handwrite your `sidebars.js` file), and use the `slug` front matter to customize URLs of each document. Our recommendation for file system organization is: make your file system mirror the sidebar structure (so you don't need to handwrite your `sidebars.js` file), and use the `slug` front matter to customize URLs of each document.
Add a section explaining that setting the `id` frontmatter will also affect the published path of the document, making it `/{id}` instead of `/{filename}`.