Skip to content

Commit 24ff886

Browse files
authored
chore: moving ordering to category jsons and frontmatters (#3777)
# Description This big PR does a simple thing: It makes pages ordering respect metadata instead of filenames ## Problem\* A naive approach supported over the years at docusaurus was to simply have files prefixed with 00, 01, 02, which were removed automatically by docusaurus. This makes docs a bit harder to maintain if for some reason you decide to move pages around, as it breaks all the links. ## Summary\* - Renames all the folders and pages to remove the prefixes - Adds `sidebar_position` property in frontmatter, to order them - Adds `_category_.json` files to order folders - Removes ordering of top level folders in `sidebars.json`
1 parent 4718606 commit 24ff886

68 files changed

Lines changed: 274 additions & 72 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
{
2+
"position": 3,
3+
"collapsible": true,
4+
"collapsed": true
5+
}
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"label": "Modules, Packages and Crates",
3+
"position": 2,
4+
"collapsible": true,
5+
"collapsed": true
6+
}

docs/docs/explanations/02_modules_packages_crates/crates_and_packages.md renamed to docs/docs/explanations/modules_packages_crates/crates_and_packages.md

Lines changed: 1 addition & 0 deletions

docs/docs/explanations/02_modules_packages_crates/dependencies.md renamed to docs/docs/explanations/modules_packages_crates/dependencies.md

Lines changed: 1 addition & 0 deletions

docs/docs/explanations/02_modules_packages_crates/modules.md renamed to docs/docs/explanations/modules_packages_crates/modules.md

Lines changed: 1 addition & 0 deletions

docs/docs/explanations/02_modules_packages_crates/workspaces.md renamed to docs/docs/explanations/modules_packages_crates/workspaces.md

Lines changed: 2 additions & 1 deletion
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"label": "Noir",
3+
"position": 0,
4+
"collapsible": true,
5+
"collapsed": true
6+
}

docs/docs/explanations/00_noir/04_assert.md renamed to docs/docs/explanations/noir/assert.md

Lines changed: 1 addition & 0 deletions

docs/docs/explanations/00_noir/09_comments.md renamed to docs/docs/explanations/noir/comments.md

Lines changed: 1 addition & 0 deletions

docs/docs/explanations/00_noir/02_control_flow.md renamed to docs/docs/explanations/noir/control_flow.md

Lines changed: 1 addition & 0 deletions

0 commit comments

Comments
 (0)