Skip to content

[release/v26.2.x] operator: link cloud_storage_* field docs to the object storage page (#2001) - #2005

Merged
JakeSCahill merged 2 commits into
release/v26.2.xfrom
backport-2001-v26.2.x
Oct 26, 2026
Merged

JakeSCahill merged 2 commits into
release/v26.2.xfrom
backport-2001-v26.2.x

Conversation

@JakeSCahill

Copy link
Copy Markdown
Contributor

Backport of #2001 to release/v26.2.x.

The cloud_storage_* field comments in RedpandaClusterSpec.config link to anchors on the wrong page. The anchors exist only on the object storage properties page, but the links point at the cluster and tunable properties pages, so readers of the CRD reference and kubectl explain land on a page without the property. This points the 29 links at the object storage properties page.

  • The Go change touches only // comment lines (58 changed lines, all comments).
  • The CRD manifest and testdata/crd-docs.adoc are regenerated on this branch with the pinned tools (controller-gen 0.20.1, crd-ref-docs 0.3.0), running the commands from k8s:generate. A regeneration of the unmodified branch had no drift first.
  • Every changed line in all four files matches operator: link cloud_storage_* field docs to the object storage page #2001 exactly.

The changelog entry from #2001 is included, so 26.2 patch release notes list the fix.

Backport of #2001. The cloud_storage_* field comments in
RedpandaClusterSpec.config linked to the cluster and tunable properties
pages with anchors that only exist on the object storage properties
page. Point the 29 links there and regenerate the CRD manifest and the
crd-docs testdata.
@secpanda

secpanda commented Oct 22, 2026 •

Copy link
Copy Markdown

✅ Snyk checks have passed. No issues have been found so far.

Status Scan Engine Critical High Medium Low Total (0)
✅ Open Source Security 0 0 0 0 0 issues
✅ Licenses 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

The thread-per-core section's anchor is tpc, not thread-per-core-model, so
the link landed at the top of the page and the docs link converter leaves
it as a raw URL. Comment-only change; the CRD bases and the crd-docs test
fixture carry the same text.
@JakeSCahill
JakeSCahill marked this pull request as ready for review October 23, 2026 13:04
@JakeSCahill
JakeSCahill merged commit 2aae48d into release/v26.2.x Oct 26, 2026
14 checks passed
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.

3 participants