docs: add sizing guide for Sourcebot deployments

[brendan-kellam]

Summary

Add a comprehensive sizing guide to help users choose the right infrastructure for their Sourcebot deployments. Recommendations are based on real-world customer deployments ranging from 100 to 40,000+ repositories.

The guide provides CPU, memory, and disk allocation recommendations across four deployment tiers (small to extra-large), explains how to calculate disk requirements, and includes practical tuning strategies for resource-constrained environments. Also updates the overview page to link to the new guide.

Highlights

• Sizing recommendations based on repository count
• Disk usage calculation (2-3x codebase size)
• External Postgres/Redis recommendations for stability
• Memory optimization for Zoekt search performance
• Monitoring and tuning guidance

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Added a new sizing guide providing deployment recommendations across four tier levels with CPU, memory, disk, and repository count guidance.
  • Updated documentation navigation to include the sizing guide.
  • Added reference to the sizing guide from the scalability section.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between fbf3984 and 647666d.

📒 Files selected for processing (4)

• CLAUDE.md
• docs/docs.json
• docs/docs/deployment/sizing-guide.mdx
• docs/docs/overview.mdx

---

Walkthrough

Documentation additions including a new deployment sizing guide, navigation menu updates to reference the guide, and a development guideline reminder about changelog entries for documentation-only changes. No functional code changes.

Changes

Cohort / File(s)	Summary
Sizing Guide Documentation docs/docs/deployment/sizing-guide.mdx	New comprehensive sizing guide for Sourcebot deployments covering repository counts, resource allocation (CPU, memory, disk) across four tiers, external service recommendations, disk usage considerations, and tuning/concurrency guidance.
Documentation Navigation & References docs/docs.json, docs/docs/overview.mdx	Added sizing-guide entry to deployment navigation menu and included link reference in overview.mdx Scalability section to direct users to detailed sizing recommendations.
Development Guidelines CLAUDE.md	Added documentation rule clarifying that CHANGELOG entries should not be created for documentation-only changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

• chore(readme): Update README with new videos #410: Modifies docs/docs/overview.mdx to change video source; related due to shared file edits in documentation overview section.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch brendan-kellam/check-circleback

---

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 and usage tips.}

[github-actions]

@brendan-kellam your pull request is missing a changelog!