From c965b7e98edfc06c1b36dbf0f7ba381e523eaab9 Mon Sep 17 00:00:00 2001 From: peterjunpark Date: Mon, 20 Oct 2025 18:11:38 -0400 Subject: [PATCH] Add custom version history (#5551) --- docs/about/versions.md | 23 ++++++++++++++++++++++ docs/conf.py | 4 +++- docs/sphinx/static/version-history-link.js | 16 +++++++++++++++ 3 files changed, 42 insertions(+), 1 deletion(-) create mode 100644 docs/about/versions.md create mode 100644 docs/sphinx/static/version-history-link.js diff --git a/docs/about/versions.md b/docs/about/versions.md new file mode 100644 index 000000000..df41d1a74 --- /dev/null +++ b/docs/about/versions.md @@ -0,0 +1,23 @@ + + + + + + +# ROCm preview release history + +| Version | Release date | +| ------- | ------------ | +| [7.9.0](https://rocm.docs.amd.com/en/docs-7.9.0/) | October 20, 2025 | + +```{important} +ROCm 7.9.0 introduces a versioning discontinuity following +the previous 7.0 releases. Versions 7.0 through 7.8 are reserved for +production stream ROCm releases, while versions 7.9 and later represent the +technology preview release stream. + +Maintaining parallel release streams allows users ample time to evaluate and +adopt the new build system and dependency changes. The technology preview +stream is planned to continue through mid‑2026, after which it will replace the +[current production stream](https://rocm.docs.amd.com/en/latest/). +``` diff --git a/docs/conf.py b/docs/conf.py index 9db708aec..317da0c82 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -122,13 +122,15 @@ external_toc_path = "./sphinx/_toc.yml" # Register Sphinx extensions and static assets sys.path.append(str(DOCS_DIR / "extension")) -# html_static_path = ["sphinx/static/css", "extension/how-to/rocm-for-ai/inference"] +html_static_path = ["sphinx/static"] +# "sphinx/static/css", "extension/how-to/rocm-for-ai/inference"] # html_css_files = [ # "rocm_custom.css", # "rocm_rn.css", # "dynamic_picker.css", # "vllm-benchmark.css", # ] +html_js_files = ["version-history-link.js"] templates_path = ["extension/rocm_docs_custom/templates", "extension/templates"] extensions = [ diff --git a/docs/sphinx/static/version-history-link.js b/docs/sphinx/static/version-history-link.js new file mode 100644 index 000000000..bb73fdc47 --- /dev/null +++ b/docs/sphinx/static/version-history-link.js @@ -0,0 +1,16 @@ +function ready(callback) { + if (document.readyState !== "loading") { + callback(); + return; + } + document.addEventListener("DOMContentLoaded", callback); +} + +ready(() => { + const versionListLink = document.querySelector( + "a.header-all-versions[href='https://rocm.docs.amd.com/en/latest/release/versions.html']", + ); + versionListLink.textContent = "Preview versions"; + versionListLink.href = + "https://rocm.docs.amd.com/en/docs-7.9.0/about/versions.html"; +});