Conversation
There was a problem hiding this comment.
Pull request overview
Adds a consolidated “Sizing guide” reference page and updates existing docs to point readers to it, replacing scattered sizing/storage guidance previously linked from a Discourse post.
Changes:
- Update COS/COS Lite tutorials and reference pages to link to the new sizing guide for production sizing guidance.
- Expand
system-requirements.mdinto a sizing guide with workload tables, combined-workload formulas, and storage-retention estimation. - Consolidate storage sizing guidance into reference docs (notably
storage.md) and reorganize the Reference index navigation.
Reviewed changes
Copilot reviewed 9 out of 9 changed files in this pull request and generated 8 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/tutorial/cos-lite-microk8s-sandbox.md | Adds a link from tutorial prerequisites to the sizing guide for production guidance. |
| docs/tutorial/cos-lite-canonical-k8s-sandbox.md | Adds a sizing-guide pointer in prerequisites. |
| docs/tutorial/cos-canonical-k8s-sandbox.md | Adds a sizing-guide pointer in prerequisites. |
| docs/reference/topology.md | Adds a sizing-guide link from COS Lite topology description. |
| docs/reference/system-requirements.md | Renames/reframes as “Sizing guide” and adds workload sizing + formulas + storage estimation. |
| docs/reference/storage.md | Replaces Discourse sizing reference with sizing-guide link and adds storage recommendation tables. |
| docs/reference/index.md | Adds a “Sizing & capacity” section and moves sizing/storage entries into it. |
| docs/how-to/configure-and-tune/evaluate-telemetry-volume.md | Updates resource-requirements link target to the sizing guide. |
| docs/explanation/architecture/stack-variants.md | Adds a link from the comparison table to the sizing guide. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Leon <82407168+sed-i@users.noreply.github.com>
There was a problem hiding this comment.
This doc is being removed in #262 . If this information is still needed - can you put it somewhere else?
| --- | ||
|
|
||
| # Storage Best Practices | ||
| # Storage best practices |
There was a problem hiding this comment.
Add a line between the H1 and H2 with context, like "Use this document to plan storage for a COS or COS Lite deployment."
|
|
||
| ## General-purpose storage recommendations | ||
|
|
||
| The following estimates are based on past experience for medium-sized COS stacks. |
There was a problem hiding this comment.
If you can provide any more detail here, that would be helpful. It's not clear what a "medium-sized" stack is to me.
If you don't have more details to provide (i.e., these are just observational estimations), then leave as is
There was a problem hiding this comment.
The formatting for this one is off from the rest of the docs - you should remove the line limits
In this PR: