chore: clarify rbac example

[DavudSafarli]

Improve RoleID Guidance and Scoping explanations in Keto RBAC Guide

Summary by CodeRabbit

• Documentation
  • Reorganized RBAC documentation in the sidebar by moving it from the Concepts section to the Guides section for improved navigation and discoverability.

[Copilot]

Pull request overview

Clarifies the RBAC guide for Ory Keto by improving how the OPL schema is referenced and expanding guidance around scoping/object IDs to avoid cross-tenant collisions.

Changes:

• Replaces the plain “OPL schema” mention with an explicit link to the Ory Permission Language reference.
• Adds a new “Object ID guidance” section explaining object ID collision risks and recommended ID formats.
• Removes the older “Role ID guidance” section later in the document in favor of the earlier, expanded guidance.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[coderabbitai]

📝 Walkthrough

Walkthrough

The sidebars-network.ts file is updated to reorganize the RBAC documentation entry within the Docusaurus sidebar structure. The keto/guides/rbac entry is moved from the Concepts section to the Guides section under the Fine-grained Permissions → keto category.

Changes

Sidebar Navigation Structure

Layer / File(s)	Summary
Sidebar Configuration sidebars-network.ts	keto/guides/rbac documentation entry is relocated from the "Concepts" items list to the "Guides" items list within the Fine-grained Permissions keto category.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested reviewers

• aeneasr
• piotrmsc
• vinckr

Poem

📚 A guide finds its place,

From concepts to guides it moves with grace,

RBAC docs now shine so bright,

In the perfect sidebar spot, just right! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The PR description is minimal and lacks required template sections. It does not follow the repository's description template with missing sections like 'Related Issue or Design Document' and 'Checklist'.	Add the missing required sections from the template: specify the related issue reference (e.g., #2548), include the checklist with confirmation items, and provide more detailed explanation of changes in the 'big picture' section.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The PR title 'chore: clarify rbac example' is partially related to the changeset. While the PR includes RBAC documentation clarifications, the specific change in this file is moving RBAC content from Concepts to Guides in the sidebar—not actually clarifying the example itself.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch keto-rbac-1

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

• Generate code and open pull requests
• Plan features and break down work
• Investigate incidents and troubleshoot customer tickets together
• Automate recurring tasks and respond to alerts with triggers
• Summarize progress and report instantly

Built for teams:

• Shared memory across your entire org—no repeating context
• Per-thread sandboxes to safely plan and execute work
• Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[unatasha8]

LGTM