Skip to content

Conversation

@TimLFletcher
Copy link
Contributor

Capella docs have the guardrails discussion that also applies to server... so I'm bringing it in here as a result of a CBSE.

Linked issue in docs-devex DOC-13223-new

|Free Disk Space
|\<= 4%

|# of Buckets
Copy link
Contributor

Choose a reason for hiding this comment

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

Is it better to spell out as "Number of Buckets",
as use of the octothorpe is not entirely universal beyond American English?
(Close to universal, but not as unambiguous as writing 'number')

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I think that's a fair suggestion. Changed.

|Cluster Metric |Threshold

|Data Service Resident Ratio (Couchstore)
|\<= 1%
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think this is fine, but I did wonder if it needs the backslash escape?
and whether <= is clear enough without explanation (but should be fine, is used elsewhere in docs-server in a text context, once, and I don't see any counter-indications in the style guide.

@TimLFletcher TimLFletcher merged commit 11b7734 into release/7.6 May 16, 2025
@TimLFletcher TimLFletcher deleted the DOC-13223 branch May 16, 2025 14:19
ggray-cb pushed a commit that referenced this pull request Aug 11, 2025
* DOC-13223: Added guardrails details to server docs

* Update sizing-general.adoc
ggray-cb pushed a commit that referenced this pull request Aug 26, 2025
* DOC-13223: Added guardrails details to server docs

* Update sizing-general.adoc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants