Skip to content

docs: add topology-based project structure decision tree#7517

Merged
Holmus merged 2 commits into
mainfrom
docs/project-structure-decision-tree
May 22, 2026
Merged

docs: add topology-based project structure decision tree#7517
Holmus merged 2 commits into
mainfrom
docs/project-structure-decision-tree

Conversation

@Holmus
Copy link
Copy Markdown
Contributor

@Holmus Holmus commented May 14, 2026

Summary

  • Adds a "Decision tree: pick a structure by topology" section to structuring-your-projects.md, placed between "Understanding Flagsmith's data model" and "When to create separate projects".
  • Four-row table keyed on customer topology (single product / multiple products / independent team ownership / default), each with a concise recommendation.
  • First row references using tags, naming conventions, and tag-based RBAC to manage scope within a single project.

Closes #7507.

@Holmus Holmus requested a review from a team as a code owner May 14, 2026 14:28
@Holmus Holmus requested review from adamvialpando and removed request for a team May 14, 2026 14:28
@vercel
Copy link
Copy Markdown

vercel Bot commented May 14, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 22, 2026 11:59am
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
flagsmith-frontend-preview Ignored Ignored Preview May 22, 2026 11:59am
flagsmith-frontend-staging Ignored Ignored Preview May 22, 2026 11:59am

Request Review

Copy link
Copy Markdown

@claude claude Bot left a comment

Choose a reason for hiding this comment

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

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.

Tip: disable this comment in your organization's Code Review settings.

@matthewelwell
Copy link
Copy Markdown
Contributor

/gemini review

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request updates the project structuring documentation by adding a "Decision tree: pick a structure by topology" section. This section includes a table that provides recommendations on whether to use a single project or multiple projects based on business topology, such as team ownership and product context. I have no feedback to provide.

Comment thread docs/docs/best-practices/structuring-your-projects.md Outdated
Address Matt's review comment: "Splitting later is reversible" reads as
if the act of splitting could be undone, which isn't true. Replace with
a clearer call-to-action that drops the splitting/merging tangent.
@Holmus Holmus merged commit 896067f into main May 22, 2026
11 checks passed
@Holmus Holmus deleted the docs/project-structure-decision-tree branch May 22, 2026 12:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: Project structure decision guide (expand existing best-practices page)

2 participants