DOC-7104: Migrate content/operate/rs/security/ to render hooks - #4088
Merged
Merged
Conversation
Converts every file under content/operate/rs/security/ (39 files) from the relref link shortcode and note/tip/warning/alert callout shortcodes to their render-hook equivalents: plain Markdown links resolved by layouts/_default/_markup/render-link.html, and `> [!NOTE]` etc. blockquotes resolved by layouts/_default/_markup/render-blockquote.html. Purely mechanical syntax migration, no prose/terminology/fact changes. 294 relref shortcodes and 45 callout shortcodes converted across 38 of the 39 files (access-control/manage-users/_index.md had none to convert). Hand-fix: 13 callout instances across 7 files (recommended-security-practices, certificates/certificate-based-authentication, certificates/create-certificates, certificates/updating-certificates, access-control/create-users, access-control/saml-sso, access-control/ldap/map-ldap-groups-to-roles) were indented inside a list item. The mechanical converter reindented the blockquote's header line but not its continuation/closing lines, which would have detached the callout from its <li> nesting. Reindented every continuation line to match the header's indentation and confirmed via rendered-HTML diff that the surrounding <li>/<ul>/<ol> structure is byte-identical before and after for all 7 files. Verified: hugo --minify build before/after is byte-identical in href set (build/diff_rendered_hrefs.py, 47 pages compared, 0 diffs) and in build warnings/errors (145 before, 145 after, no new entries — remaining warnings/errors are pre-existing and unrelated: jupyter-example examples.json gaps under content/develop/clients/, and a JS-minification failure on /commands/cf.reserve/ that needs network access unavailable in this sandbox). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Contributor
Contributor
🧠 Redis MemoryFound 5 related items from repository history (5 new this commit):
Memory updated at 167fa5f |
Contributor
This was referenced Sep 23, 2026
Merged
andy-stark-redis
requested review from
dwdougherty
and removed request for
kaitlynmichael
September 23, 2026 15:21
Contributor
Author
|
Follow-up: the bare /commands link in security/access-control/redis-acl-overview.md is fixed in #4103, along with a few other link issues found by review on this migration's sibling PRs. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Unit 3 of 15 in the shortcode-to-render-hook migration (DOC-7104), extending
the pattern already shipped across
content/develop/,content/commands/,content/operate/oss_and_stack/,content/integrate/, and the RDI productinto Redis Software's
content/operate/rs/security/directory.relreflink shortcode to plain Markdown links, resolved bylayouts/_default/_markup/render-link.html.note/tip/warning/alertcallout shortcodes to> [!NOTE]etc. blockquotes, resolved bylayouts/_default/_markup/render-blockquote.html.Scope
content/operate/rs/security/(
access-control/manage-users/_index.mdhad no relref/callout shortcodes toconvert).
Hand-fixes / findings
across 7 files (
recommended-security-practices.md,certificates/certificate-based-authentication.md(×2),certificates/create-certificates.md(×4),certificates/updating-certificates.md,access-control/create-users.md,access-control/saml-sso.md(×4),access-control/ldap/map-ldap-groups-to-roles.md) were indented inside alist item. The mechanical converter reindented the blockquote's header line
but left its continuation/closing lines unindented, which would have
detached the callout from its
<li>nesting. Hand-fixed by reindentingevery continuation line to match the header's indentation, and confirmed via
rendered-HTML diff that the surrounding
<li>/<ul>/<ol>structure isbyte-identical before and after for all 7 files.
<note>/<tip>/<warning>wrappers, no unquoted
title=attributes, and no genuine no-slash relrefconcatenation bugs found. Three
relref ... >}}#anchorinstances inaccess-control/redis-acl-overview.mdmatched that no-slash-concatenationshape but are not the bug — they're the standard fragment-suffix idiom
(
]({{< relref "X" >}}#anchor)), which converts cleanly since a fragmentnever needs a leading slash.
Verification
hugo --minifybuilt before and after conversion (using the patchedbuild/diff_rendered_hrefs.pyfrom the not-yet-mergedDOC-7104-diff-hrefs-fixbranch, pulled into the worktree for verificationonly — not included in this PR's diff).
build/diff_rendered_hrefs.pyscoped tooperate/rs/security: 47 pagescompared, 0 href diffs.
entries). Remaining warnings/errors are pre-existing and unrelated to this
change:
jupyter-exampleshortcodeexamples.jsongaps undercontent/develop/clients/, and a JS-minification failure on/commands/cf.reserve/that requires network access unavailable in thissandbox.
Test plan
with hand-fixed indented callouts, to confirm callouts render nested
correctly inside their list items
🤖 Generated with Claude Code
Note
Low Risk
Documentation-only syntax migration with no product or security-behavior changes; link correctness depends on existing render hooks and was verified with href diff tooling per the PR.
Overview
Mechanical Hugo shortcode migration across Redis Software security docs (
content/operate/rs/security/, 38 files): internal links move from{{< relref ... >}}to plain Markdown paths under/content/..., and callouts move from{{< note >}}/{{< warning >}}/{{< tip >}}to GitHub-style> [!NOTE](etc.) blockquotes for the render-link and render-blockquote hooks.No terminology or procedural changes—only link and admonition syntax. A handful of list-nested callouts were reindented so blockquote continuation lines stay inside their list items (seven files). The security index link table and cross-links to REST API, LDAP, TLS, certificates, and access-control topics all use the new path style (including
_index.mdwhere section roots apply).Reviewed by Cursor Bugbot for commit 167fa5f. Bugbot is set up for automated code reviews on this repo. Configure here.