Skip to content

docs: add Organizations & Permissions section under AI builder [ENG-10395]#6802

Open
adhami3310 wants to merge 1 commit into
mainfrom
claude/org-namespace-docs-a7b870
Open

docs: add Organizations & Permissions section under AI builder [ENG-10395]#6802
adhami3310 wants to merge 1 commit into
mainfrom
claude/org-namespace-docs-a7b870

Conversation

@adhami3310

Copy link
Copy Markdown
Member

New docs/ai_builder/organization/ section (11 pages) documenting organizations and permissions end to end:

  • Overview, Members & seats, Roles & permissions, Managing project access, Custom roles
  • Verified domains, Single sign-on (SSO)
  • Deployment approvals, Audit logs, Moving projects & apps, Bring your own cloud

Also wires the section into the AI builder docs sidebar and cross-links from hosting/adding-members and hosting/billing.

Content is sourced from the shipped flexgen org/permission model (org roles Admin/Manager/Member, project roles Viewer/Editor/Admin plus custom roles). Screenshots are live on the CDN under docs-preview/organization/….

Add docs/ai_builder/organization/ covering organizations end to end: overview, members & seats, roles & permissions, managing project access, custom roles, verified domains, SSO, deployment approvals, audit logs, moving projects & apps, and bring-your-own-cloud. Wire the section into the AI builder docs sidebar and cross-link from hosting/adding-members and hosting/billing.
@adhami3310
adhami3310 requested review from a team and Alek99 as code owners July 20, 2026 19:34
@adhami3310 adhami3310 changed the title docs: add Organizations & Permissions section under AI builder docs: add Organizations & Permissions section under AI builder [ENG-10395] Jul 20, 2026
@linear-code

linear-code Bot commented Jul 20, 2026

Copy link
Copy Markdown

ENG-10395

@codspeed-hq

codspeed-hq Bot commented Jul 20, 2026

Copy link
Copy Markdown

Merging this PR will not alter performance

✅ 26 untouched benchmarks
⏩ 8 skipped benchmarks1


Comparing claude/org-namespace-docs-a7b870 (8ee00ca) with main (f79d011)

Open in CodSpeed

Footnotes

  1. 8 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports.

@greptile-apps

greptile-apps Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR adds a new Organizations & Permissions section to the AI Builder docs — 11 pages covering the full org/project access model — and wires it into the sidebar and cross-links from existing hosting pages.

  • Eleven new markdown pages document the complete organization lifecycle: members & seats, org/project roles and permissions, custom roles, verified domains, SSO, deployment approvals, audit logs, project/app moves, and bring-your-own-cloud.
  • sidebar_items/ai.py registers the new section between App Lifecycle and the commented-out Integrations block; item.py gets a new \"Sso\" → \"SSO\" acronym entry.
  • All internal cross-links were verified against actual files in the repo, and all referenced CDN image URLs follow the established docs-preview/organization/… pattern.

Confidence Score: 4/5

Safe to merge — purely additive documentation with no runtime logic changes.

The change is documentation-only: new markdown files, sidebar wiring, and two cross-link alerts. All internal links were verified against existing files, the acronym map entry follows the established pattern, and the content is internally consistent across all 11 pages. The only note is a pre-existing commented-out Integrations block that remains in the file touched by this PR.

The commented-out Integrations block in docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/ai.py is the only item worth a second look, though it predates this PR.

Important Files Changed

Filename Overview
docs/ai_builder/organization/audit_logs.md New doc for audit logs; internal links and role references are consistent with the rest of the section.
docs/ai_builder/organization/cloud_providers.md New doc for Bring Your Own Cloud; correctly notes GCP availability and placeholders for AWS/Azure; cross-links to existing hosting pages verified.
docs/ai_builder/organization/custom_roles.md New doc for custom roles with permission table; content is internally consistent with roles_and_permissions.md.
docs/ai_builder/organization/deployment_approvals.md New doc for deployment approval flow; clearly separates requester vs approver roles.
docs/ai_builder/organization/domains.md New doc for verified domains and auto-join; SSO prerequisite relationship documented correctly.
docs/ai_builder/organization/members.md New doc for members and seats; pending/awaiting-a-seat distinction is clear.
docs/ai_builder/organization/moving_projects_and_apps.md New doc for moving projects/apps; member-loss warning is prominently called out.
docs/ai_builder/organization/overview.md New overview doc; three-level hierarchy diagram and settings-level table are accurate; 'In this section' links match sidebar order.
docs/ai_builder/organization/project_access.md New doc for project access management; org-admin auto-access badge behavior documented correctly.
docs/ai_builder/organization/roles_and_permissions.md New roles reference doc; org-role and project-role permission tables are internally consistent and match custom_roles.md.
docs/ai_builder/organization/sso.md New SSO doc; requires verified domain as prerequisite, correctly gates setup on domain verification.
docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/ai.py Wires the 11-page Organization section into the sidebar; pre-existing commented-out Integrations block remains in the touched file.
docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/item.py Adds 'Sso' -> 'SSO' to acronym map; follows the same pattern as existing entries.
docs/hosting/adding-members.md Adds info alert cross-linking to the new organization section; links verified correct.
docs/hosting/billing.md Adds info alert pointing seats/members/roles readers to the new organization section; links verified correct.

Comments Outside Diff (1)

  1. docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/ai.py, line 975-990 (link)

    P2 Pre-existing commented-out block in touched file

    The # create_item("Integrations", ...) block was already present before this PR, but since ai.py is modified here it surfaces the team's rule to remove commented-out code before merging. If this block is still needed (e.g., to preserve context for when the section is re-enabled), consider replacing it with a short inline comment rather than keeping the full commented-out code block.

    Rule Used: Remove commented-out code before merging PRs. (source)

    Learned From
    reflex-dev/reflex-web#1619

    Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Reviews (1): Last reviewed commit: "docs: add Organizations & Permissions se..." | Re-trigger Greptile

@adhami3310 adhami3310 added the documentation Improvements or additions to documentation label Jul 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant