Skip to content

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

Open
Holmus wants to merge 1 commit into
mainfrom
docs/project-structure-decision-tree
Open

docs: add topology-based project structure decision tree#7517
Holmus wants to merge 1 commit 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 14, 2026 2:29pm
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
flagsmith-frontend-preview Ignored Ignored Preview May 14, 2026 2:29pm
flagsmith-frontend-staging Ignored Ignored Preview May 14, 2026 2:29pm

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.

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)

1 participant