## Summary
**What** — What changes are introduced in this PR?
Related PR #13946
Add custom admin route ranking documentation
**Why** — Why are these changes relevant or necessary?
*Please provide answer here*
**How** — How have these changes been implemented?
*Please provide answer here*
**Testing** — How have these changes been tested, or how can the reviewer test the feature?
*Please provide answer here*
---
## Examples
Provide examples or code snippets that demonstrate how this feature works, or how it can be used in practice.
This helps with documentation and ensures maintainers can quickly understand and verify the change.
```ts
// Example usage
```
---
## Checklist
Please ensure the following before requesting a review:
- [ ] I have added a **changeset** for this PR
- Every non-breaking change should be marked as a **patch**
- To add a changeset, run `yarn changeset` and follow the prompts
- [ ] The changes are covered by relevant **tests**
- [ ] I have verified the code works as intended locally
- [ ] I have linked the related issue(s) if applicable
---
## Additional Context
Add any additional context, related issues, or references that might help the reviewer understand this PR.
---
> [!NOTE]
> Adds admin UI docs for sidebar route ranking (including nested), sorting rules, and examples using CodeTabs; mirrors updates in the public content file.
>
> - **Docs (Admin UI Routes)** in `www/apps/book/app/learn/fundamentals/admin/ui-routes/page.mdx`:
> - Add `rank` property to `defineRouteConfig` docs and explain sidebar ordering.
> - New section: "Specify UI Route Sidebar Rank" with version note (v2.11.4).
> - Add sorting rules for ranked vs. unranked routes.
> - Add "Nested UI Routes Ranking" with examples under `orders`.
> - Provide two example routes (Analytics, Reports) demonstrating rank via `CodeTabs`/`CodeTab` (and import them).
> - Minor copy tweaks (e.g., possessive fix in `label` description).
> - **Public content mirror** in `www/apps/book/public/llms-full.txt`:
> - Sync the above additions: `rank` property, ranking section, sorting rules, nested ranking examples, and copy fixes.
>
> <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 1d127afbfb01e034c39b0b02081781bd0a8e29ef. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>
Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>
* docs: how to add new admin route under existing route
* docs: update about defineRouteConfig
* docs: add new line
Co-authored-by: Shahed Nasser <shahednasser@gmail.com>
* docs: add new line
---------
Co-authored-by: Shahed Nasser <shahednasser@gmail.com>
Shahed Nasser
Bastien
mathieuh
Victor Wilson
Eugene Pro