docs(experimentation): add experimentation architecture to platform architecture page

[gagantrivedi]

Thanks for submitting a PR! Please check the boxes below:

• I have read the Contributing Guide.
• I have added information to docs/ if required so people know about the feature.
• I have filled in the "Changes" section below.
• I have filled in the "How did you test this code" section below.

Changes

First of a series of small PRs documenting experimentation infrastructure.

• Add the experimentation components (ingestion server, Kafka, warehouse delivery, warehouse) to the Conceptual Overview.
• Add an experimentation subsection and diagram to each deployment model: SaaS and Self-Hosted / On-Premises.
• Explain how SaaS (managed ClickHouse) and self-hosted (your own warehouse) differ.

How did you test this code?

Validated the SVG with xmllint and rendered it to PNG with rsvg-convert. Page not yet checked in make serve.

[vercel]

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

Project	Deployment	Actions	Updated
docs	Ready	Preview	Oct 16, 2026 10:53am UTC
flagsmith-frontend-preview	Ready	Preview	Oct 16, 2026 10:53am UTC
flagsmith-frontend-staging	Ready	Preview	Oct 16, 2026 10:53am UTC

[coderabbitai]

Important

Review skipped

Review was skipped as selected files did not have any reviewable changes.

⛔ Files ignored due to path filters: 2

• docs/static/img/experimentation-architecture-saas.svg is excluded by !**/*.svg
• docs/static/img/experimentation-architecture-self-hosted.svg is excluded by !**/*.svg

⚙️ Run configuration

• Configuration used: Organization UI
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: 03525739-07fc-4ffe-9c65-e0f1048179a0

📥 Commits

Reviewing files that changed from the base of the PR and between 0f13cc9 and ab4d411.

⛔ Files ignored due to path filters: 2

• docs/static/img/experimentation-architecture-saas.svg is excluded by !**/*.svg
• docs/static/img/experimentation-architecture-self-hosted.svg is excluded by !**/*.svg

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: Organization UI
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: b5063d8f-cbb5-44b3-97c0-14b08c04ccbe

📥 Commits

Reviewing files that changed from the base of the PR and between 24b8f8b and 0f13cc9.

📒 Files selected for processing: 1

• docs/docs/experimentation/connect-a-warehouse.md

💤 Files with no reviewable changes: 1

• docs/docs/experimentation/connect-a-warehouse.md

Included review availability: This review used your included allowance. Your plan provides up to 8 included reviews per hour; 6 remain after this review.

📝 Walkthrough

The architecture overview adds ingestion, Kafka, warehouse delivery, and warehouse components. It describes event routes for SaaS, self-hosted, and on-premises deployments, with architecture diagrams. The warehouse connection guide removes the statement that experiment results and exposure queries use only the managed Flagsmith warehouse and cannot be served directly from customer ClickHouse.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~4 minutes

Merge Risk: ⚪ Minimal · up to 0f13c

The warehouse documentation is consistent with the current query-serving behavior. No actionable merge-blocking risk remains after normal checks.

- [ ] Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

---

ℹ️ Review info

⚙️ Run configuration

• Configuration used: Organization UI
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: 5cd88aba-54e2-4fea-bfdf-3b7c82c48c7d

📥 Commits

Reviewing files that changed from the base of the PR and between a630eb9 and 24b8f8b.

⛔ Files ignored due to path filters: 2

• docs/static/img/experimentation-architecture-saas.svg is excluded by !**/*.svg
• docs/static/img/experimentation-architecture-self-hosted.svg is excluded by !**/*.svg

📒 Files selected for processing: 1

• docs/docs/flagsmith-concepts/platform-architecture.md

Included review availability: This review used your included allowance. Your plan provides up to 8 included reviews per hour; 7 remain after this review.