Skip to content

DOC-7128 k8s: convert kubernetes/ images - #4178

Merged
andy-stark-redis merged 1 commit into
mainfrom
DOC-7128-k8s
Oct 2, 2026
Merged

andy-stark-redis merged 1 commit into
mainfrom
DOC-7128-k8s

Conversation

@andy-stark-redis

@andy-stark-redis andy-stark-redis commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Converts the image shortcodes in content/operate/kubernetes/ to Markdown images, using the codemod from #4151. The scope is the unversioned pages plus all six version snapshots, as in DOC-7120. Part of DOC-7128. This is mechanical: no product-name wording or CRD identifiers are touched.

Counts: 92 images converted in 22 files:

Tree Images
Unversioned 7
8.0.18/ 7
8.0/ 7
7.22/ 7
7.8.6/ 20
7.8.4/ 20
7.4.6/ 24

4 shortcodes stay as shortcodes, because the codemod can't convert them safely: one line in 7.4.6/architecture holds two images, and the faqs pages in 7.4.6/ and 7.8.4/ each have an image that shares a paragraph with text. This tree has no raw relative <img> tags, so it doesn't have the problem #4175 fixes in rs/.

Rendered changes: none, apart from the dropped <a sdata-lightbox> wrapper.

Verification

  • Built main and this branch under the production baseURL (/docs/latest/): both succeeded (19,664 pages), and the hook reported no missing images.
  • Compared src/width/alt/class for every image on every page: no differences. In the rendered Kubernetes pages, sdata-lightbox wrappers go from 57 to 4 (the 4 skipped shortcodes), which confirms the converted pages were rebuilt.
  • The codemod deleted exactly one line per converted shortcode (92) and touched no file outside the list.
  • AI Markdown feed for kubernetes/: no attribute lines and no relative /images/ links, and the same 57 absolute image URLs before and after.
  • Not render-verified: 39 of the 92 images are on deployment/openshift/old-index.md in the 7.4.6, 7.8.4, and 7.8.6 snapshots. Those pages set draft: true and hidden: true, and their body never renders, even with --buildDrafts. No reader sees them in any build. They use the same standalone-in-list-item pattern that the build confirmed on rendered pages.

🤖 Generated with Claude Code


Note

Low Risk
Docs-only markup migration with build verification; the main behavioral delta is loss of lightbox wrapping on converted images, not product or runtime logic.

Overview
Replaces 92 standalone Hugo {{< image filename="..." >}} shortcodes in content/operate/kubernetes/ with plain Markdown ![](/images/...) (and ![Upgrade flowchart](...) where alt was set on the upgrade flowchart). The change spans the unversioned tree and version snapshots (7.4.6, 7.8.4, 7.8.6, 7.22, 8.0, 8.0.18) across architecture, deployment-options, OpenShift legacy guides, and upgrade pages—no prose or API reference edits.

Reader-visible effect: images should look the same except the shortcode lightbox link wrapper (sdata-lightbox) is no longer emitted for converted figures. Four shortcodes are intentionally unchanged (dual images on one line in 7.4.6/architecture, plus FAQ images inline with text in 7.4.6/ and 7.8.4/).

Reviewed by Cursor Bugbot for commit 9a9b2ec. Bugbot is set up for automated code reviews on this repo. Configure here.

Runs build/migrate_image_shortcodes.py over 22 files in
content/operate/kubernetes/ (unversioned pages and all six snapshots),
converting 92 image shortcodes to Markdown images. 4 that the codemod can't
convert safely stay as shortcodes. There are no raw relative <img> tags in
this tree.

39 of the 92 are on deployment/openshift/old-index.md in the 7.4.6, 7.8.4, and
7.8.6 snapshots, which set draft: true and hidden: true. Their body never
renders, even with --buildDrafts, so a render comparison can't check them.
They use the same standalone-in-list-item pattern verified on rendered pages.

Gaps: the 39 images on the draft, hidden old-index pages could not be render-verified
Ticket: DOC-7128
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

DOC-7128

@github-actions

github-actions Bot commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

Staging links:
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.22/architecture/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.22/architecture/deployment-options/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.4.6/architecture/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.4.6/architecture/operator/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.4.6/deployment/deployment-options/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.4.6/deployment/openshift/old-getting-started-openshift-crdb/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.4.6/deployment/openshift/old-index/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.4.6/upgrade/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.8.4/architecture/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.8.4/architecture/deployment-options/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.8.4/deployment/openshift/old-getting-started-openshift-crdb/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.8.4/deployment/openshift/old-index/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.8.6/architecture/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.8.6/architecture/deployment-options/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.8.6/deployment/openshift/old-getting-started-openshift-crdb/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/7.8.6/deployment/openshift/old-index/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/8.0.18/architecture/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/8.0.18/architecture/deployment-options/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/8.0/architecture/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/8.0/architecture/deployment-options/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/architecture/
https://redis.io/docs/staging/DOC-7128-k8s/operate/kubernetes/architecture/deployment-options/

@github-actions

github-actions Bot commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

🧠 Redis Memory

Found 5 related items from repository history (5 new this commit):

Memory updated at 9a9b2ec

@dwdougherty dwdougherty left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM.

@andy-stark-redis andy-stark-redis self-assigned this Oct 1, 2026
@andy-stark-redis
andy-stark-redis merged commit 9bcc798 into main Oct 2, 2026
99 checks passed
@andy-stark-redis
andy-stark-redis deleted the DOC-7128-k8s branch October 2, 2026 10:15
EliShteinman added a commit to EliShteinman/docs that referenced this pull request Oct 2, 2026
Converts the image shortcodes in content/operate/kubernetes/ to Markdown images.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DU7o4C5U81DPthewNFn28D
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants