Skip to content

DOC-7086: Migrate RDI reference/ core + data-transformation/ to render hooks - #4058

Merged
andy-stark-redis merged 1 commit into
mainfrom
DOC-7086-rdi-reference-core
Sep 18, 2026
Merged

andy-stark-redis merged 1 commit into
mainfrom
DOC-7086-rdi-reference-core

Conversation

@andy-stark-redis

@andy-stark-redis andy-stark-redis commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

Summary

Unit 6 of 7 for DOC-7086 (RDI shortcode migration, continuing DOC-6909/7047/7055/7059/7074/7079/7080). Converts the relref link shortcode and note/warning/tip/info/alert callout shortcodes to native markdown links and GitHub-style > [!NOTE] blockquote alerts (render hooks), for this unit's scope only:

  • Live tree: content/integrate/redis-data-integration/reference/ top-level pages (_index.md, api-migration.md, api-reference.md, config-yaml-reference.md, jmespath-custom-functions.md) plus all of reference/data-transformation/
  • 1.19.1 supported-version snapshot: the equivalent files under content/integrate/redis-data-integration/1.19.1/reference/

reference/cli/ (a sibling unit) and all other RDI directories (root pages, architecture/, installation/, data-pipelines/, release-notes/) are untouched.

Scope: 26 files scanned, 14 changed. The other 12 (api-reference.md, jmespath-custom-functions.md, config-yaml-reference.md, data-transformation/_index.md, remove_field.md, rename_field.md, and their 1.19.1 mirrors) had no relref/callout shortcodes to convert.

config-yaml-reference.md was called out as recently rewritten upstream (RDSC-5610, #4029/#4030) in the live tree. Ran a fresh scan rather than trusting any stale pre-scan count: confirmed 0 relref/callout shortcodes in both the live and 1.19.1 copies — its links are all in-page #anchor references into its own generated property tables.

Converted (fresh count, this unit only): 33 relref links + 2 note callouts (1 in live api-migration.md, 1 in its 1.19.1 mirror) across the 14 changed files. No list-nested callouts and no malformed no-space shortcode tags found in scope.

Verification

  • Ran build/migrate_shortcode_links.py all against this unit's 26 files.
  • Built this branch and a fresh origin/main baseline with Hugo (output formats temporarily trimmed to HTML/RSS for build speed, reverted before commit — no config.toml diff in this PR).
  • Diffed rendered hrefs with build/diff_rendered_hrefs.py: 0 href diffs, 0 new warnings, both scoped to the integrate/redis-data-integration/ prefix (434 vs 434 pages) and on a full-site comparison (7231 vs 7231 pages, ignoring the two known-nondeterministic families per project memory).

Test plan

  • build/migrate_shortcode_links.py run only against this unit's files
  • No remaining relref/callout shortcodes in the 26 in-scope files
  • No list-nested callout indentation issues found
  • Hugo build succeeds on both branches
  • diff_rendered_hrefs.py reports 0 diffs (prefix-scoped and full-site)
  • config.toml output-format trim reverted before commit

🤖 Generated with Claude Code


Note

Low Risk
Docs-only link and callout formatting with no product or API behavior changes.

Overview
Continues the RDI shortcode-to-render-hook migration (DOC-7086) for reference content: Hugo relref links become native markdown targets under /content/integrate/redis-data-integration/..., and the API migration note callout becomes a > [!NOTE] blockquote.

The same edits are mirrored in the 1.19.1 supported-version snapshot. Scope is reference landing pages, api-migration.md, and the data-transformation reference pages (cache, add_field, filter, map, lookup, etc.); sibling areas such as reference/cli/ are intentionally untouched.

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

…r hooks

Converts unit 6 of the RDI shortcode migration: the top-level pages
directly inside content/integrate/redis-data-integration/reference/
(_index.md, api-migration.md, api-reference.md, config-yaml-reference.md,
jmespath-custom-functions.md) plus everything under reference/data-transformation/,
in both the live tree and the 1.19.1 supported-version snapshot.

Ran build/migrate_shortcode_links.py (all stages) against the 26 files in
scope. 14 files actually changed -- the other 12 (api-reference.md,
jmespath-custom-functions.md, config-yaml-reference.md,
data-transformation/_index.md, remove_field.md, rename_field.md, and their
1.19.1 mirrors) had no relref or callout shortcodes to convert.

config-yaml-reference.md was flagged as recently rewritten upstream
(RDSC-5610, #4029/#4030) in the live tree only. Re-scanned fresh rather than
trusting any prior pre-scan count: confirmed 0 relref/callout shortcodes in
both the live and 1.19.1 copies -- its links are all in-page `#anchor`
references into its own generated property tables, nothing to convert.

Converted 33 relref links and 2 note callouts (1 live + 1 in 1.19.1, both in
api-migration.md) total across the 14 changed files. No list-nested
callouts and no malformed no-space shortcode tags found in this unit's
scope.

Verified with a full-site Hugo build (outputs trimmed to HTML/RSS for build
speed, reverted before commit) diffed via build/diff_rendered_hrefs.py
against a fresh origin/main baseline build: 0 href diffs, 0 new warnings,
under both the integrate/redis-data-integration/ prefix filter and a
full-site comparison (ignoring the two known-nondeterministic families).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

DOC-7086

@github-actions

Copy link
Copy Markdown
Contributor

Staging links:
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/1.19.1/reference/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/1.19.1/reference/api-migration/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/1.19.1/reference/data-transformation/add_field/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/1.19.1/reference/data-transformation/cache/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/1.19.1/reference/data-transformation/filter/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/1.19.1/reference/data-transformation/lookup/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/1.19.1/reference/data-transformation/map/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/reference/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/reference/api-migration/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/reference/data-transformation/add_field/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/reference/data-transformation/cache/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/reference/data-transformation/filter/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/reference/data-transformation/lookup/
https://redis.io/docs/staging/DOC-7086-rdi-reference-core/integrate/redis-data-integration/reference/data-transformation/map/

@github-actions

Copy link
Copy Markdown
Contributor

🧠 Redis Memory

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

Memory updated at 3675be4

@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. 🫠

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