Skip to content

docs: sync Pool -> StoragePool CRD rename and maxLogicalVolumeCount -> maxSubsystemCount - #195

Merged
noctarius merged 2 commits into
mainfrom
docs/rename-pool-to-storagepool-crd
Aug 21, 2026
Merged

docs: sync Pool -> StoragePool CRD rename and maxLogicalVolumeCount -> maxSubsystemCount#195
noctarius merged 2 commits into
mainfrom
docs/rename-pool-to-storagepool-crd

Conversation

@boddumanohar

Copy link
Copy Markdown
Member

Summary

Syncs the documentation with two CRD changes merged into simplyblock-operator main:

Files changed:

  • docs/reference/operator/reference.md — regenerated via scripts/operator-reference-gen.sh against operator main, but scoped to only the delta these two PRs introduce. The checked-in reference is separately behind operator main by other, unrelated already-merged PRs (e.g. the ClusterOps CR work, failure-domain changes) — those are out of scope here and left untouched to keep this diff focused.
  • docs/reference/operator/index.md — hand-written overview: Pool CRD table row/example/anchors, maxLogicalVolumeCount example values and overrides table.
  • docs/kubernetes/installation/k8s-storage-plane.md — storage pool creation walkthrough (kind: Pool example, maxLogicalVolumeCount, and a stale kubectl get simplyblockpool command corrected to the actual resource name kubectl get storagepools).
  • docs/kubernetes/operations/scaling/expanding-storage-cluster.mdmaxLogicalVolumeCount in node-expansion examples.

Note: deployment/ (the built, versioned doc site) is CI-managed via doc-builder deploy and is not hand-edited here.

Test plan

  • Review rendered docs (./doc-builder serve) for the changed pages.
  • Confirm docs/reference/operator/reference.md renders cleanly and cross-references (#storagepool, #storagepoolspec) resolve.

🤖 Generated with Claude Code

@github-actions

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/docs-rename-pool-to-storagepool-crd

@boddumanohar
boddumanohar marked this pull request as ready for review August 21, 2026 15:31
@boddumanohar
boddumanohar force-pushed the docs/rename-pool-to-storagepool-crd branch from 3e12104 to 42366d0 Compare August 21, 2026 15:33
@boddumanohar boddumanohar self-assigned this Aug 21, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/docs-rename-pool-to-storagepool-crd

boddumanohar and others added 2 commits August 21, 2026 18:10
…> maxSubsystemCount

Matches simplyblock-operator#413 (field rename) and #414 (CRD kind
rename), both merged into operator main. Regenerated
docs/reference/operator/reference.md via scripts/operator-reference-gen.sh
against operator main, isolating just the delta these two changes
introduce (the checked-in reference.md is separately behind operator
main by other unrelated merged PRs, left untouched here).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…ence

The Pool -> StoragePool rename is correct and kept. Three problems in the
accompanying changes are fixed here, all verified against the operator CRDs
in simplyblock-operator (operator/api/v1alpha1, operator/config/crd/bases).

maxSubsystemCount is a required field on StorageCluster only. It is not part
of StorageNodeSetSpec or StorageNodeOverrides, so renaming the removed
maxLogicalVolumeCount to it moved a valid field onto the wrong CRDs. Because
CRDs prune unknown fields, those manifests would have applied cleanly and
silently done nothing. The field is removed from the StorageNodeSet and
StorageNode examples instead.

partitions and corePercentage do not exist on StorageNodeSet either and were
already removed from the operator reference on main. They are dropped from the
expansion examples as well.

The StoragePool section appended to docs/reference/operator/reference.md was a
byte-identical duplicate of the section already generated on main, which gave
the page two #storagepool anchors. That file is generated and is reverted;
it is regenerated with scripts/operator-reference-gen.sh, never edited by hand.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@noctarius
noctarius force-pushed the docs/rename-pool-to-storagepool-crd branch from 42366d0 to 66730f6 Compare August 21, 2026 16:14
@noctarius
noctarius merged commit de5d7ac into main Aug 21, 2026
3 checks passed
@noctarius
noctarius deleted the docs/rename-pool-to-storagepool-crd branch August 21, 2026 16:15
@github-actions

Copy link
Copy Markdown
Contributor

🤖: Deployment available as https://docstest.simplyblock.io/docs-rename-pool-to-storagepool-crd

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.

2 participants