## 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>
Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action
---
> [!NOTE]
> Bumps Medusa UI-related dependencies across apps/packages and updates DatePicker prop type metadata in UI specs.
>
> - **Dependencies**:
> - Upgrade `@medusajs/icons` to `2.12.0` across apps/packages.
> - Upgrade `@medusajs/ui` to `4.0.28` in `apps/api-reference`, `apps/ui`, and `packages/docs-ui`.
> - Upgrade `@medusajs/ui-preset` to `2.12.0` in `apps/ui` and `packages/tailwind`.
> - Update `yarn.lock` accordingly.
> - **UI Reference**:
> - Update `DatePicker` prop type metadata for `onBlur`, `onFocus`, `onKeyDown`, and `onKeyUp` in `apps/ui/specs/components/DatePicker/DatePicker.json`.
>
> <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 222e08dc7d3aa920103aa9b35c50207dca4dd32f. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>
Co-authored-by: Oli Juhl <59018053+olivermrbl@users.noreply.github.com>
* docs(learn): updated user stories
* Correct case in title for Advanced Fulfillment use case
* Update href for Advanced Fulfillment use case
---------
Co-authored-by: Shahed Nasser <shahednasser@gmail.com>
Shahed Nasser
github-actions[bot]
Bastien
Adrien de Peretti
khai-pi
cboeddek