Skip to content

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

Merged
masenf merged 2 commits into
mainfrom
claude/org-namespace-docs-a7b870
Jul 22, 2026
Merged

docs: add Organizations & Permissions section under AI builder [ENG-10395]#6802
masenf merged 2 commits 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 (7b0c553) with main (f79d011)2

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.

  2. No successful run was found on main (e54bc83) during the generation of this report, so f79d011 was used instead as the comparison base. There might be some changes unrelated to this pull request in this report.

@greptile-apps

greptile-apps Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR adds a complete "Organizations & Permissions" documentation section (11 new pages) under the AI Builder docs, wires it into the sidebar, and adds cross-link alerts in two existing hosting pages.

  • Eleven new .md pages cover the full org/project permission model: overview, members & seats, roles & permissions, project access, custom roles, verified domains, SSO, deployment approvals, audit logs, moving projects/apps, and bring-your-own-cloud.
  • The sidebar (ai.py) gains a new "Organization" group referencing all 11 pages; item.py adds "Sso" → "SSO" to the acronym normalization map so the sidebar label renders correctly.
  • hosting/adding-members.md and hosting/billing.md each receive a short info alert redirecting readers to the new section.

Confidence Score: 5/5

Safe to merge — pure documentation addition with no runtime logic changes.

All changes are Markdown content and two small Python additions (a sidebar group and an acronym entry). The permission tables and cross-links are internally consistent across the 11 new pages. No runtime code is modified.

No files require special attention. The pre-existing commented-out Integrations block in ai.py was already noted in a previous review cycle.

Important Files Changed

Filename Overview
docs/ai_builder/organization/overview.md New overview page for the Organizations section; explains hierarchy, settings levels, creation/deletion, and links to all sub-pages
docs/ai_builder/organization/members.md New page covering member management, seats, invitations, awaiting-a-seat queue, and role changes
docs/ai_builder/organization/roles_and_permissions.md New page with permission tables for org roles (Admin/Manager/Member) and project roles (Viewer/Editor/Admin); internally consistent with other new pages
docs/ai_builder/organization/custom_roles.md New page on custom project roles; permission table is consistent with roles_and_permissions.md; correctly notes managing-members/managing-roles cannot be delegated
docs/ai_builder/organization/project_access.md New page on per-project member management, role assignment, and removal
docs/ai_builder/organization/domains.md New page on domain verification, auto-join, sync, seat-queue behavior, and relation to SSO
docs/ai_builder/organization/sso.md New SSO page covering SAML/OIDC setup, sign-in flow, and disabling; accurately requires a verified domain first
docs/ai_builder/organization/deployment_approvals.md New page on deployment approval gates; correctly describes who can approve and the pending-approval flow
docs/ai_builder/organization/audit_logs.md New page on org and project audit logs; access restrictions are consistent with roles_and_permissions.md
docs/ai_builder/organization/moving_projects_and_apps.md New page on moving projects between organizations and apps between projects; correctly warns about member access loss
docs/ai_builder/organization/cloud_providers.md New Bring-Your-Own-Cloud page covering GCP connection, credential storage note, disconnection side-effects, and namespace isolation
docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/ai.py Adds Organization section to sidebar; pre-existing commented-out Integrations block remains (flagged in previous review)
docs/app/reflex_docs/templates/docpage/sidebar/sidebar_items/item.py Adds "SSO" to the acronym normalization map so sidebar displays it uppercased correctly
docs/hosting/adding-members.md Adds an info alert cross-linking to the new Organizations section; links are correct
docs/hosting/billing.md Adds an info alert pointing readers to the Members & seats and Roles & permissions docs; links are correct

Reviews (2): Last reviewed commit: "use explicit kwargs with color_mode_cond" | Re-trigger Greptile

@adhami3310 adhami3310 added the documentation Improvements or additions to documentation label Jul 20, 2026

@masenf masenf left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good, running it locally

Comment thread docs/ai_builder/organization/roles_and_permissions.md
Co-authored-by: Masen Furer <m_github@0x26.net>
@masenf
masenf merged commit 9854a3a into main Jul 22, 2026
108 checks passed
@masenf
masenf deleted the claude/org-namespace-docs-a7b870 branch July 22, 2026 00:24
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.

2 participants