Skip to content

docs: add sub-organizations documentation#5359

Merged
maidul98 merged 5 commits intomainfrom
igor/eng-4528-add-documentation-for-sub-orgs
Feb 4, 2026
Merged

docs: add sub-organizations documentation#5359
maidul98 merged 5 commits intomainfrom
igor/eng-4528-add-documentation-for-sub-orgs

Conversation

@IgorHorta
Copy link
Contributor

Context

Add documentation for the sub-organizations feature (ENG-4528).

Sub-organizations allow enterprises to create autonomous child organizations within a parent organization, enabling team segmentation while sharing authentication and billing.

Changes:

  • Add comprehensive Sub-Organizations section to organization.mdx
  • Add brief sub-org reference to organization-structure.mdx guide
  • Fix incorrect "sub-organizations" terminology (was referring to folders)
  • Add UI screenshots for sub-org workflows

Screenshots

N/A - Documentation only

Steps to verify the change

  1. Run docs locally: cd docs && mintlify dev
  2. Navigate to http://localhost:3000/documentation/platform/organization
  3. Verify the Sub-Organizations section renders correctly with Mermaid diagram and images

Type

  • Fix
  • Feature
  • Improvement
  • Breaking
  • Docs
  • Chore

Checklist

IgorHorta and others added 2 commits February 3, 2026 18:26
Add comprehensive documentation for the sub-organizations feature:

- Add Sub-Organizations section to organization.mdx with concepts,
  resource model, limitations, workflows, and Mermaid diagram
- Fix incorrect "sub-organizations" terminology in organization-structure.mdx
- Add brief sub-organizations section to organization structure guide
- Add UI screenshots for sub-org list, creation, and resource management

Co-authored-by: Cursor <cursoragent@cursor.com>
- Simplify Mermaid diagram to show clean hierarchy
- Fix creation steps: Organization tab → + New Sub-Organization
- Add missing sub-org-list.png image reference

Co-authored-by: Cursor <cursoragent@cursor.com>
@linear
Copy link

linear bot commented Feb 3, 2026

@greptile-apps
Copy link
Contributor

greptile-apps bot commented Feb 3, 2026

Greptile Overview

Greptile Summary

This PR adds comprehensive documentation for the Sub-Organizations feature to Infisical's documentation. The changes include:

  • New Sub-Organizations section in organization.mdx with detailed explanation of the feature, use cases, resource model, and step-by-step workflows
  • Brief Sub-Organizations reference added to organization-structure.mdx guide to maintain consistency across documentation
  • Terminology fix in organization-structure.mdx line 43 where "sub-organizations" was incorrectly used to refer to folders
  • Three UI screenshots added to illustrate the sub-org creation and resource management workflows
  • Mermaid diagram showing the hierarchical relationship between root and sub-organizations

The documentation is well-structured, clear, and follows the existing Mintlify documentation patterns used throughout the project. All image references are valid and the content is accurate for an enterprise feature.

Confidence Score: 5/5

  • This PR is safe to merge with no risk - documentation-only changes
  • Score reflects documentation-only changes with no code modifications, proper image assets, correct terminology fixes, and clear, well-structured content that follows existing documentation patterns
  • No files require special attention

Important Files Changed

Filename Overview
docs/documentation/platform/organization.mdx Added comprehensive Sub-Organizations documentation with clear structure, examples, and usage guidelines
docs/documentation/guides/organization-structure.mdx Added Sub-Organizations section to guide and fixed incorrect terminology about folders

@IgorHorta IgorHorta changed the title Igor/eng 4528 add documentation for sub orgs docs: add sub-organizations documentation Feb 3, 2026
@maidul98 maidul98 self-requested a review February 3, 2026 21:46
@maidul98
Copy link
Collaborator

maidul98 commented Feb 3, 2026

Snyk checks have passed. No issues have been found so far.

Status Scanner Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

Copy link
Collaborator

@maidul98 maidul98 left a comment

Choose a reason for hiding this comment

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

i don't think we didn't mention what resources from a parent organization can be inherited down

@maidul98 maidul98 merged commit 9877d2c into main Feb 4, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants