Skip to content

docs: fix duplicate sidebar order number#2071

Merged
alexeyv merged 2 commits intobmad-code-org:mainfrom
eatse21:fix/docs-sidebar-numbering
Mar 20, 2026
Merged

docs: fix duplicate sidebar order number#2071
alexeyv merged 2 commits intobmad-code-org:mainfrom
eatse21:fix/docs-sidebar-numbering

Conversation

@eatse21
Copy link
Copy Markdown
Contributor

@eatse21 eatse21 commented Mar 20, 2026

Summary

Fixes duplicate sidebar order numbers in the How-To section. Both customize-bmad.md and project-context.md were set to order: 7, causing ordering conflicts in the sidebar navigation.

Root Cause

  • customize-bmad.mdorder: 7
  • project-context.mdorder: 7 (duplicate)

Changes

  • Bumped project-context.md sidebar order from 78
  • Bumped shard-large-documents.md sidebar order from 89
  • Applied fix to both English and Chinese (zh-cn) documentation

Test plan

The sidebar elements keep their old "guessed" order, now in a non-conflicting way

how-to/ customize-bmad.md and project-context.md had the same order
number
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 20, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 219b29af-2ef8-4b26-bbed-aefda52e921c

📥 Commits

Reviewing files that changed from the base of the PR and between a092209 and 6c32493.

📒 Files selected for processing (4)
  • docs/how-to/project-context.md
  • docs/how-to/shard-large-documents.md
  • docs/zh-cn/how-to/project-context.md
  • docs/zh-cn/how-to/shard-large-documents.md

📝 Walkthrough

Walkthrough

Documentation navigation ordering updates across English and Chinese documentation files. The sidebar.order values are incremented to adjust page positioning in the sidebar, with no functional or content modifications.

Changes

Cohort / File(s) Summary
English Documentation
docs/how-to/project-context.md, docs/how-to/shard-large-documents.md
Updated sidebar.order from 7→8 and 8→9 respectively to reorder navigation.
Chinese Documentation
docs/zh-cn/how-to/project-context.md, docs/zh-cn/how-to/shard-large-documents.md
Updated sidebar.order from 7→8 and 8→9 respectively to reorder navigation.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately and concisely describes the main change: fixing duplicate sidebar order numbers in the documentation.
Description check ✅ Passed The description clearly explains the issue (duplicate order numbers), the root cause, specific changes made, and testing approach, all directly related to the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Tip

You can make CodeRabbit's review stricter and more nitpicky using the `assertive` profile, if that's what you prefer.

Change the reviews.profile setting to assertive to make CodeRabbit's nitpick more issues in your PRs.

@alexeyv
Copy link
Copy Markdown
Collaborator

alexeyv commented Mar 20, 2026

Thank you!

@alexeyv alexeyv merged commit a2839cb into bmad-code-org:main Mar 20, 2026
5 checks passed
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