Skip to content

align mintlify nav with current docs structure #2526

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.

Sign up for GitHub

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

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

align mintlify nav with current docs structure #2526

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 36 additions & 15 deletions docs/docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,7 @@
{
"group": "Usage",
"pages": [
"usage/readme",
"usage/modules",
"usage/blueprints",
"usage/configuration",
Expand All @@ -49,6 +50,7 @@
{
"group": "Data streams",
"pages": [
"usage/data_streams/readme",
Comment on lines 38 to +53

@greptile-apps greptile-apps Bot Jun 18, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 README filename case mismatch may break page resolution

The three new entries usage/readme, usage/data_streams/readme, and usage/sensor_streams/readme reference lowercase readme, but the actual files on disk are docs/usage/README.md, docs/usage/data_streams/README.md, and docs/usage/sensor_streams/README.md (all uppercase). On the case-sensitive Linux filesystem where Mintlify typically deploys, these lookups will fail to resolve the file, resulting in 404s. The other pages in this codebase all use lowercase filenames consistently — consider renaming the three README.md files to readme.md.

"usage/data_streams/advanced_streams",
"usage/data_streams/quality_filter",
"usage/data_streams/reactivex",
Expand All @@ -59,6 +61,7 @@
{
"group": "Sensor streams",
"pages": [
"usage/sensor_streams/readme",
"usage/sensor_streams/advanced_streams",
"usage/sensor_streams/quality_filter",
"usage/sensor_streams/reactivex",
Expand All @@ -76,30 +79,45 @@
]
},
{
"group": "Agents",
"group": "Coding agents",
"pages": [
"agents/index",
"agents/style",
"agents/code-quality-rules",
"agents/testing",
"coding-agents/index",
"coding-agents/style",
"coding-agents/code-quality-rules",

@greptile-apps greptile-apps Bot Jun 18, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Missing file: coding-agents/code-quality-rules

docs/coding-agents/code-quality-rules.md does not exist in the repository. Adding it to the nav will produce a broken sidebar link that 404s for visitors.

"coding-agents/testing",
"coding-agents/worktrees",
{
"group": "Authoring agent docs",
"pages": [
"agents/docs/index",
"agents/docs/codeblocks",
"agents/docs/doclinks"
"coding-agents/docs/index",
"coding-agents/docs/codeblocks",
"coding-agents/docs/doclinks"
]
}
]
Comment on lines +82 to 97

@greptile-apps greptile-apps Bot Jun 18, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 No redirects from old agents/* paths to new coding-agents/* paths

The group was renamed from agents to coding-agents and all page paths updated accordingly, but no redirects entries have been added to docs.json for the old URLs (agents/index, agents/style, agents/testing, agents/docs/index, etc.). Anyone who bookmarked or linked to those pages will hit 404s. Mintlify supports "redirects": [{"source": "/agents/index", "destination": "/coding-agents/index"}] entries at the top level of docs.json.

},
{
"group": "Capabilities",
"pages": [
{
"group": "Agents",
"pages": [
"capabilities/agents/readme"
]
},
{
"group": "Manipulation",
"pages": [
"capabilities/manipulation/readme",
"capabilities/manipulation/adding_a_custom_arm",
"capabilities/manipulation/openarm_integration"
"capabilities/manipulation/openarm_integration",
"capabilities/manipulation/a750"
]
},
{
"group": "Mapping",
"pages": [
"capabilities/mapping/relocalization"
]
},
{
Expand All @@ -113,13 +131,15 @@
{
"group": "Navigation",
"pages": [
"capabilities/navigation/readme",
"capabilities/navigation/nav_stack",
{
"group": "Native",
"pages": [
"capabilities/navigation/native/index"
]
}
"capabilities/navigation/native/index"
]
},
{
"group": "Perception",
"pages": [
"capabilities/perception/readme"
]
},
{
Expand Down Expand Up @@ -156,6 +176,7 @@
"development/grid_testing",
"development/large_file_management",
"development/profiling_dimos",
"development/releasing",
"development/writing_docs"
]
}
Expand Down
Loading