From 28d5ca194cef19468376860d19dcafc6476f901a Mon Sep 17 00:00:00 2001 From: Andy Stark Date: Mon, 5 Oct 2026 11:39:38 +0100 Subject: [PATCH] DOC-7128: make the RedisVL sync emit Markdown images, and convert its 19 copies build/redisvl_docs_sync.py turned upstream `![alt](_static/x)` images into the image shortcode, so converting the synced files by hand would have been undone by the next sync. It now emits `![alt](/images/redisvl/x)`, and the 19 copies of the architecture diagram (one per RedisVL version) are converted to match. The script's new output is byte-identical to the converted lines, so the next sync regenerates them with no churn. With this, no content file uses the image shortcode, and none render anywhere on the site. Verified under the production baseURL: all 19 diagrams render with an identical src/width/alt/class at /docs/latest/images/redisvl/..., and the AI Markdown feed keeps its 19 absolute image URLs. Constraint: redisvl_docs_sync.py must emit Markdown images; reverting it to the shortcode would bring back a shortcode the site no longer defines once it's retired Ticket: DOC-7128 Co-Authored-By: Claude Opus 5.5 --- build/redisvl_docs_sync.py | 2 +- content/develop/ai/redisvl/0.15.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.16.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.17.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.17.1/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.18.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.18.1/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.18.2/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.19.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.20.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.20.1/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.22.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.23.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.24.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.25.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.25.1/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.26.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.27.0/concepts/architecture.md | 2 +- content/develop/ai/redisvl/0.27.1/concepts/architecture.md | 2 +- content/develop/ai/redisvl/concepts/architecture.md | 2 +- 20 files changed, 20 insertions(+), 20 deletions(-) diff --git a/build/redisvl_docs_sync.py b/build/redisvl_docs_sync.py index f527165c04..71d1f410c5 100644 --- a/build/redisvl_docs_sync.py +++ b/build/redisvl_docs_sync.py @@ -650,7 +650,7 @@ def transform_page(src: Path, staging: Path, moved_slugs: list[str]) -> None: text = moved_re.sub(r'relref "\1/how_to_guides/\2"', text) text = _rewrite_bare_relref_for_moved_layout(text, src, staging, moved_slugs) text = _IMAGE_STATIC.sub( - lambda m: f'{{{{< image filename="/images/redisvl/{m.group(2)}" alt="{m.group(1)}" >}}}}', + lambda m: f'![{m.group(1)}](/images/redisvl/{m.group(2)})', text, ) # Upstream `user_guide/cli.ipynb` links to `../api/cli.rst`, but no such diff --git a/content/develop/ai/redisvl/0.15.0/concepts/architecture.md b/content/develop/ai/redisvl/0.15.0/concepts/architecture.md index 3645c0ca0c..aef07863a6 100644 --- a/content/develop/ai/redisvl/0.15.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.15.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.15.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.16.0/concepts/architecture.md b/content/develop/ai/redisvl/0.16.0/concepts/architecture.md index ee4329f5e1..5f6f456a99 100644 --- a/content/develop/ai/redisvl/0.16.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.16.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.16.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.17.0/concepts/architecture.md b/content/develop/ai/redisvl/0.17.0/concepts/architecture.md index de493eca5e..425386b41e 100644 --- a/content/develop/ai/redisvl/0.17.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.17.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.17.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.17.1/concepts/architecture.md b/content/develop/ai/redisvl/0.17.1/concepts/architecture.md index b604174cdb..03a49406b1 100644 --- a/content/develop/ai/redisvl/0.17.1/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.17.1/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.17.1/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.18.0/concepts/architecture.md b/content/develop/ai/redisvl/0.18.0/concepts/architecture.md index 5f746be490..b35ff787d5 100644 --- a/content/develop/ai/redisvl/0.18.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.18.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.18.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.18.1/concepts/architecture.md b/content/develop/ai/redisvl/0.18.1/concepts/architecture.md index 334b772ec5..c9ff047fb8 100644 --- a/content/develop/ai/redisvl/0.18.1/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.18.1/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.18.1/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.18.2/concepts/architecture.md b/content/develop/ai/redisvl/0.18.2/concepts/architecture.md index d924bcb512..8698b48876 100644 --- a/content/develop/ai/redisvl/0.18.2/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.18.2/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.18.2/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.19.0/concepts/architecture.md b/content/develop/ai/redisvl/0.19.0/concepts/architecture.md index 64eb0f4a1b..2bc388f99b 100644 --- a/content/develop/ai/redisvl/0.19.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.19.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.19.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.20.0/concepts/architecture.md b/content/develop/ai/redisvl/0.20.0/concepts/architecture.md index ec249245dc..4df418fb87 100644 --- a/content/develop/ai/redisvl/0.20.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.20.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.20.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.20.1/concepts/architecture.md b/content/develop/ai/redisvl/0.20.1/concepts/architecture.md index 7a1ac2f1be..93e87407d9 100644 --- a/content/develop/ai/redisvl/0.20.1/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.20.1/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.20.1/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.22.0/concepts/architecture.md b/content/develop/ai/redisvl/0.22.0/concepts/architecture.md index c96f82cbda..37998d939a 100644 --- a/content/develop/ai/redisvl/0.22.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.22.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.22.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.23.0/concepts/architecture.md b/content/develop/ai/redisvl/0.23.0/concepts/architecture.md index 0fe419c3cf..aa3faad192 100644 --- a/content/develop/ai/redisvl/0.23.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.23.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.23.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.24.0/concepts/architecture.md b/content/develop/ai/redisvl/0.24.0/concepts/architecture.md index 64d1bdb44c..09ce502103 100644 --- a/content/develop/ai/redisvl/0.24.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.24.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.24.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.25.0/concepts/architecture.md b/content/develop/ai/redisvl/0.25.0/concepts/architecture.md index 739367be9a..0c141d1d35 100644 --- a/content/develop/ai/redisvl/0.25.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.25.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.25.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.25.1/concepts/architecture.md b/content/develop/ai/redisvl/0.25.1/concepts/architecture.md index 3c2a709715..3b733e2528 100644 --- a/content/develop/ai/redisvl/0.25.1/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.25.1/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.25.1/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.26.0/concepts/architecture.md b/content/develop/ai/redisvl/0.26.0/concepts/architecture.md index 8c2471d030..02a514f002 100644 --- a/content/develop/ai/redisvl/0.26.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.26.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.26.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.27.0/concepts/architecture.md b/content/develop/ai/redisvl/0.27.0/concepts/architecture.md index 9424598a6c..ace9eaf553 100644 --- a/content/develop/ai/redisvl/0.27.0/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.27.0/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.27.0/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/0.27.1/concepts/architecture.md b/content/develop/ai/redisvl/0.27.1/concepts/architecture.md index 3d1482aaa5..2d6525e6c6 100644 --- a/content/develop/ai/redisvl/0.27.1/concepts/architecture.md +++ b/content/develop/ai/redisvl/0.27.1/concepts/architecture.md @@ -7,7 +7,7 @@ url: '/develop/ai/redisvl/0.27.1/concepts/architecture/' RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern diff --git a/content/develop/ai/redisvl/concepts/architecture.md b/content/develop/ai/redisvl/concepts/architecture.md index 44103764ca..16dbae74d2 100644 --- a/content/develop/ai/redisvl/concepts/architecture.md +++ b/content/develop/ai/redisvl/concepts/architecture.md @@ -8,7 +8,7 @@ aliases: RedisVL sits between your application and Redis, providing a structured way to define, populate, and query vector search indexes. -{{< image filename="/images/redisvl/redisvl-architecture.svg" alt="RedisVL Architecture" >}} +![RedisVL Architecture](/images/redisvl/redisvl-architecture.svg) ## The Core Pattern