From c264fdc72dc8b0c55edc445c595bbacf6992e348 Mon Sep 17 00:00:00 2001
From: "Kyle J. Davis" <kyledvs@amazon.com>
Date: Tue, 27 Jan 2026 14:13:03 -0700
Subject: [PATCH 1/4] inital for version linking

Signed-off-by: Kyle J. Davis <kyledvs@amazon.com>
---
 templates/release-page.html    | 60 ++++++++++++++++++++++++++++++++++
 templates/release-section.html |  4 +--
 2 files changed, 62 insertions(+), 2 deletions(-)

diff --git a/templates/release-page.html b/templates/release-page.html
index 5467faf6..e224e49b 100644
--- a/templates/release-page.html
+++ b/templates/release-page.html
@@ -5,7 +5,67 @@ <h1 class="page-title">Download Valkey {{page.title}}</h1>
 {% endblock subhead_content%}
 {% block main_content %}
 {% set release = page.extra %}
+{% set page_ver_parts = release.tag | split(pat=".") %}
+{% set page_major = page_ver_parts.0 %}
+{% set page_minor = page_ver_parts.1 %}
+{% set page_patch = page_ver_parts.2 %}
 {% set release_date = page.date %}
+{% set this_minor_line = [] %}
+{% set this_major_line = [] %}
+{% set section_file = page.ancestors.1 %}
+{% set section = get_section(path= section_file) %}
+{% for page in section.pages %}
+    {% set this_version_parts = page.extra.tag | split(pat=".") %}
+    {% set this_version_major = this_version_parts.0 %}
+    {% set this_version_minor = this_version_parts.1 %}
+    {% set this_version_patch = this_version_parts.2 %}
+
+    {% if (page_major == this_version_major) and (page_minor == this_version_minor) %}
+        {% set ver = [ page.date, page.extra.tag, this_version_major, this_version_minor, this_version_patch, page.slug]  %}
+        {% set_global this_minor_line  = this_minor_line | concat(with= [ ver ] ) %}
+    {% endif %}
+    {% if (page_major == this_version_major) %}
+        {% set ver = [ page.date, page.extra.tag, this_version_major, this_version_minor, this_version_patch, page.slug]  %}
+        {% set_global this_major_line  = this_major_line | concat(with= [ ver ] ) %}
+    {% endif %}
+{% endfor %}
+
+{% set latest_patch = this_minor_line | sort(attribute="0") | last %}
+{% set latest_minor = this_major_line | sort(attribute="0") | last %}
+
+{% set new_patch = (latest_patch.3 == page_minor) and (latest_patch.4 != page_patch) %}
+{% set new_minor = (latest_patch.2 == page_major) and (latest_patch.3 != page_minor) %}
+patch:
+<pre>
+    {{ latest_patch | json_encode(pretty= true) | safe }}
+</pre>
+minor:
+<pre>
+    {{ latest_minor | json_encode(pretty= true) | safe }}
+</pre>
+
+
+{% if new_patch %}
+    There is a new patch version {{latest_patch.2}}.{{latest_patch.3}}.{{latest_patch.4}}
+{% endif %}
+{% if new_minor %}
+    new minor!
+{% endif %}
+
+
 
 {% include "includes/release.html" %}
+
+<script>
+const latest = () => {
+
+}
+
+document.addEventListener("DOMContentLoaded", () => {
+  console.log("page load");
+});
+window.addEventListener("hashchange", () => {
+  console.log("The hash has changed!");
+});
+</script>
 {% endblock main_content %}
diff --git a/templates/release-section.html b/templates/release-section.html
index 61f95355..e7351575 100644
--- a/templates/release-section.html
+++ b/templates/release-section.html
@@ -21,9 +21,9 @@ <h1 class="page-title">Valkey Releases</h1>
 
 {% set release_lines_unique = release_lines | unique %}
 {% for line in release_lines_unique %}
-    <h2>{{ line }}.x</h2>
+   
     <ul>
-    {% for release in section.pages | reverse %}
+    {% for release in section.pages | sort(attribute="date") | reverse %}
         {% set split_ver = release.extra.tag | split(pat=".")%}
         {% set major = split_ver | nth(n= 0) %}
         {% set minor = split_ver | nth(n= 1) %}

From d5c7cc77dc802ab3d542936025bc1d09b1f250d9 Mon Sep 17 00:00:00 2001
From: "Kyle J. Davis" <kyledvs@amazon.com>
Date: Tue, 27 Jan 2026 14:13:24 -0700
Subject: [PATCH 2/4] adding extra file

Signed-off-by: Kyle J. Davis <kyledvs@amazon.com>
---
 templates/release-page.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates/release-page.html b/templates/release-page.html
index e224e49b..9125922c 100644
--- a/templates/release-page.html
+++ b/templates/release-page.html
@@ -34,7 +34,7 @@ <h1 class="page-title">Download Valkey {{page.title}}</h1>
 {% set latest_minor = this_major_line | sort(attribute="0") | last %}
 
 {% set new_patch = (latest_patch.3 == page_minor) and (latest_patch.4 != page_patch) %}
-{% set new_minor = (latest_patch.2 == page_major) and (latest_patch.3 != page_minor) %}
+{% set new_minor = (latest_patch.2 == page_major) and (latest_patch.3 != page_minord) %}
 patch:
 <pre>
     {{ latest_patch | json_encode(pretty= true) | safe }}

From 8a8d96e9dead06140506dc2bcff0db8b8b8434d1 Mon Sep 17 00:00:00 2001
From: "Kyle J. Davis" <kyledvs@amazon.com>
Date: Thu, 29 Jan 2026 07:38:57 -0700
Subject: [PATCH 3/4] Adds logic for release pages to point to newer pages

Signed-off-by: Kyle J. Davis <kyledvs@amazon.com>
---
 templates/download.html                     |  5 +-
 templates/index.html                        | 10 +--
 templates/{includes => macros}/release.html |  6 +-
 templates/release-page.html                 | 86 ++++++++++++++-------
 4 files changed, 71 insertions(+), 36 deletions(-)
 rename templates/{includes => macros}/release.html (91%)

diff --git a/templates/download.html b/templates/download.html
index cb5b97bc..c8615b95 100644
--- a/templates/download.html
+++ b/templates/download.html
@@ -1,4 +1,5 @@
 {% extends "right-aside.html" %}
+{% import "macros/release.html" as release_macros %}
 
 {% block subhead_content%}
 <h1 class="page-title">Download Latest</h1>
@@ -31,7 +32,7 @@ <h1 class="page-title">Download Latest</h1>
 
 
 <h3> Version {{major}}.x.x </h3>
-{% include "includes/release.html" %}
+{{ release_macros::release_info(date= most_recent_release_page[0].date, release= most_recent_release_page[0].extra ) }}
 
 <h2> Latest supported version of past releases</h2>
 
@@ -42,7 +43,7 @@ <h2> Latest supported version of past releases</h2>
         {% set_global major = older_major %}
         {% set release = older_release.extra %}
         <h3> Version {{major}}.x.x </h3>
-        {% include "includes/release.html" %}
+        {{ release_macros::release_info(date= older_release.date, release= older_release.extra ) }}
     {% endif %}
 {% endfor %}
 
diff --git a/templates/index.html b/templates/index.html
index e0972bc2..21b4c774 100644
--- a/templates/index.html
+++ b/templates/index.html
@@ -1,4 +1,5 @@
 {%- extends "default.html" -%}
+{% import "macros/release.html" as release_macros %}
 
 {%- block content -%}
 {% if section.extra and section.extra.hero %}
@@ -29,15 +30,13 @@ <h1 class="hero-heading">{{ heading }}</h1>
                 {% endfor %}
                 
                 {% set most_recent_release_page = active_releases | slice(end= 1) %}
-                {% set release_date = most_recent_release_page[0].date %}
-                {% set release = most_recent_release_page[0].extra %}
                 
-                {% set split_ver = release.tag | split(pat=".")%}
+                {% set split_ver = most_recent_release_page[0].extra.tag | split(pat=".")%}
                 {% set_global major = split_ver | nth(n= 0) %}
                 
                 <h3> Version {{major}}.x.x </h3>
                 <div class="inner-card">
-                    {% include "includes/release.html" %}
+                    {{ release_macros::release_info(date= most_recent_release_page[0].date, release= most_recent_release_page[0].extra ) }}
                 </div>
 
                 <h3> Latest supported version of past releases</h3>
@@ -48,9 +47,8 @@ <h3> Latest supported version of past releases</h3>
                         {% set older_major = older_split_ver | nth(n= 0) %}
                         {% if older_major != major %}
                             {% set_global major = older_major %}
-                            {% set release = older_release.extra %}
                             <h4> Version {{major}}.x.x </h4>
-                            {% include "includes/release.html" %}
+                            {{ release_macros::release_info(date= older_release.date, release= older_release.extra ) }}
                         {% endif %}
                     {% endfor %}
                 </div>                   
diff --git a/templates/includes/release.html b/templates/macros/release.html
similarity index 91%
rename from templates/includes/release.html
rename to templates/macros/release.html
index aa26546f..ffa389cb 100644
--- a/templates/includes/release.html
+++ b/templates/macros/release.html
@@ -1,4 +1,5 @@
-<strong>Release Date:</strong>  {{ release_date | date(format="%Y-%m-%d") }} <br/> 
+{% macro release_info(date, release) %}
+<strong>Release Date:</strong>  {{ date| date(format="%Y-%m-%d") }} <br/> 
 <strong>GitHub Release:</strong> <a href="https://github.com/valkey-io/valkey/releases/tag/{{release.tag}}">{{release.tag}}</a><br />
 <hr />
 
@@ -39,3 +40,6 @@ <h4>Binary Artifacts</h4>
     {% endfor %}
 {% endfor  %}
 {% endif %}
+
+{% endmacro release_info %}
+
diff --git a/templates/release-page.html b/templates/release-page.html
index 9125922c..3a0f9b1f 100644
--- a/templates/release-page.html
+++ b/templates/release-page.html
@@ -1,71 +1,103 @@
 {% extends "right-aside.html" %}
+{% import "macros/release.html" as release_macros %}
 
 {% block subhead_content%}
 <h1 class="page-title">Download Valkey {{page.title}}</h1>
 {% endblock subhead_content%}
+
 {% block main_content %}
-{% set release = page.extra %}
-{% set page_ver_parts = release.tag | split(pat=".") %}
+{% set page_ver_parts = page.extra.tag | split(pat=".") %}
 {% set page_major = page_ver_parts.0 %}
+{% set page_major_number = page_major | int %}
 {% set page_minor = page_ver_parts.1 %}
 {% set page_patch = page_ver_parts.2 %}
-{% set release_date = page.date %}
 {% set this_minor_line = [] %}
 {% set this_major_line = [] %}
 {% set section_file = page.ancestors.1 %}
 {% set section = get_section(path= section_file) %}
-{% for page in section.pages %}
+{% set sorted_section_pages = section.pages | sort(attribute="extra.tag") %}
+{% set highest_major_version = 0 %}
+
+{% for page in sorted_section_pages %}
     {% set this_version_parts = page.extra.tag | split(pat=".") %}
     {% set this_version_major = this_version_parts.0 %}
+    {% set this_version_major_num = this_version_parts.0 | int %}
     {% set this_version_minor = this_version_parts.1 %}
     {% set this_version_patch = this_version_parts.2 %}
+    {% set this_version_rc = this_version_patch | split(pat="-") | length %}
 
+    {% set ver = [ page.date, page.extra.tag, this_version_major, this_version_minor, this_version_patch, page.slug]  %}
     {% if (page_major == this_version_major) and (page_minor == this_version_minor) %}
-        {% set ver = [ page.date, page.extra.tag, this_version_major, this_version_minor, this_version_patch, page.slug]  %}
         {% set_global this_minor_line  = this_minor_line | concat(with= [ ver ] ) %}
     {% endif %}
     {% if (page_major == this_version_major) %}
-        {% set ver = [ page.date, page.extra.tag, this_version_major, this_version_minor, this_version_patch, page.slug]  %}
         {% set_global this_major_line  = this_major_line | concat(with= [ ver ] ) %}
     {% endif %}
+    {% if (highest_major_version <= this_version_major_num) and (this_version_rc == 1) %}
+        {% set_global highest_major_version = this_version_major_num %}
+        {% set_global latest_major  = ver  %}
+    {% endif %}    
 {% endfor %}
 
 {% set latest_patch = this_minor_line | sort(attribute="0") | last %}
 {% set latest_minor = this_major_line | sort(attribute="0") | last %}
 
 {% set new_patch = (latest_patch.3 == page_minor) and (latest_patch.4 != page_patch) %}
-{% set new_minor = (latest_patch.2 == page_major) and (latest_patch.3 != page_minord) %}
-patch:
-<pre>
-    {{ latest_patch | json_encode(pretty= true) | safe }}
-</pre>
-minor:
-<pre>
-    {{ latest_minor | json_encode(pretty= true) | safe }}
-</pre>
-
+{% set new_minor = (latest_minor.2 == page_major) and (latest_minor.3 != page_minor) %}
+{% set new_major = page_major_number != highest_major_version %}
 
+{% if new_patch or new_minor or new_major %}
+<h2>Available updates for {{page.extra.tag}} </h2>
+<ul>
 {% if new_patch %}
-    There is a new patch version {{latest_patch.2}}.{{latest_patch.3}}.{{latest_patch.4}}
+    {% set_global latest_patch_url = "/download/releases/" ~ latest_patch.5 ~ "/" %}
+    <li>There is a <strong>patch</strong> update: <a href="{{ latest_patch_url | safe }}">{{latest_patch.2}}.{{latest_patch.3}}.{{latest_patch.4}}</a>.</li>
 {% endif %}
 {% if new_minor %}
-    new minor!
+    {% set_global latest_minor_url = "/download/releases/" ~ latest_minor.5 ~ "/"%}
+    <li>There is a <strong>minor</strong> update: <a href="{{ latest_minor_url | safe }}">{{latest_minor.2}}.{{latest_minor.3}}.{{latest_minor.4}}</a>.</li>
 {% endif %}
+{% if new_major %}
+    {% set_global latest_major_url = "/download/releases/" ~ latest_major.5 ~ "/" %}
+    <li>The latest <strong>major</strong> version: <a href="{{ latest_major_url | safe }}">{{latest_major.2}}.{{latest_major.3}}.{{latest_major.4}}</a>.</li>
+{% endif %}
+</ul>
+<hr />
+{%endif%}
+
+
+{{ release_macros::release_info(date= page.date, release= page.extra ) }}
+{# 
 
+The `script` tag below facilitates a forward based on a URL hashtag. For example, as of writing:
 
+- `/download/releases/v8-0-0/#latest-patch` autoforwards to `/download/releases/v8-0-6/`
+- `/download/releases/v8-0-0/#latest-minor` autoforwards to `/download/releases/v8-1-5/`
+- `/download/releases/v8-0-0/#latest-major` autoforwards to `/download/releases/v9-0-1/`
 
-{% include "includes/release.html" %}
+If there isn't a new patch/minor/major then it just becomes a noop when you add the respective hash to the URL
 
+#}
 <script>
 const latest = () => {
-
+    const lower_hash = window.location.hash.toLowerCase(window.location.hash);
+    {% if new_patch %}
+    if (lower_hash == '#latest_patch') {
+        window.location.href = '{{ latest_patch_url | safe }}';
+    }
+    {% endif %}
+    {% if new_minor %}
+    if (lower_hash == '#latest_minor') {
+        window.location.href = '{{ latest_minor_url | safe }}';
+    }
+    {% endif %}
+    {% if new_major %}
+    if (lower_hash == '#latest_major') {
+        window.location.href = '{{ latest_major_url | safe }}';
+    }
+    {% endif %}
 }
-
-document.addEventListener("DOMContentLoaded", () => {
-  console.log("page load");
-});
-window.addEventListener("hashchange", () => {
-  console.log("The hash has changed!");
-});
+document.addEventListener("DOMContentLoaded", latest);
+window.addEventListener("hashchange", latest);
 </script>
 {% endblock main_content %}

From 0e66662fd78c0143466a8283d2b29cf03e381ebe Mon Sep 17 00:00:00 2001
From: "Kyle J. Davis" <kyledvs@amazon.com>
Date: Thu, 29 Jan 2026 08:10:43 -0700
Subject: [PATCH 4/4] restores headings on release page

Signed-off-by: Kyle J. Davis <kyledvs@amazon.com>
---
 templates/release-section.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates/release-section.html b/templates/release-section.html
index e7351575..7bfab377 100644
--- a/templates/release-section.html
+++ b/templates/release-section.html
@@ -21,7 +21,7 @@ <h1 class="page-title">Valkey Releases</h1>
 
 {% set release_lines_unique = release_lines | unique %}
 {% for line in release_lines_unique %}
-   
+    <h2>{{ line }}.x</h2>
     <ul>
     {% for release in section.pages | sort(attribute="date") | reverse %}
         {% set split_ver = release.extra.tag | split(pat=".")%}