This is an automated email from the ASF dual-hosted git repository.
lidavidm pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/arrow-adbc.git
The following commit(s) were added to refs/heads/main by this push:
new 325513c39 chore: make installation page comply with policy (#3947)
325513c39 is described below
commit 325513c391770312d0989f2a28768ae5e12a76f5
Author: Bryce Mecum <[email protected]>
AuthorDate: Tue Feb 10 16:44:25 2026 -0800
chore: make installation page comply with policy (#3947)
Updates the installation page to comply with
https://infra.apache.org/release-download-pages.html#download-page. Uses
`rst_prolog` because I couldn't figure out a better way to dynamically
generate the URLs based on version.
Closes #3946
---
dev/release/utils-prepare.sh | 4 ++++
docs/source/conf.py | 12 ++++++++++++
docs/source/driver/installation.rst | 8 ++++++--
3 files changed, 22 insertions(+), 2 deletions(-)
diff --git a/dev/release/utils-prepare.sh b/dev/release/utils-prepare.sh
index 753919171..a4ba48fd2 100644
--- a/dev/release/utils-prepare.sh
+++ b/dev/release/utils-prepare.sh
@@ -34,6 +34,7 @@ update_versions() {
local java_version="${VERSION_JAVA}"
local py_version="${VERSION_NATIVE}"
local r_version="${VERSION_R}"
+ local latest_release_version="${RELEASE}"
;;
snapshot)
local c_version="${VERSION_NATIVE}-SNAPSHOT"
@@ -43,6 +44,7 @@ update_versions() {
local java_version="${VERSION_JAVA}-SNAPSHOT"
local py_version="${VERSION_NATIVE}dev"
local r_version="${PREVIOUS_VERSION_R}.9000"
+ local latest_release_version="${PREVIOUS_RELEASE}"
;;
*)
echo "Unknown type: ${type}"
@@ -98,6 +100,8 @@ update_versions() {
sed -i.bak -E "s/release = \".+\"/release = \"${docs_version}\"/g"
"${ADBC_DIR}/docs/source/conf.py"
rm "${ADBC_DIR}/docs/source/conf.py.bak"
+ sed -i.bak -E "s/latest_release = \".+\"/latest_release =
\"${latest_release_version}\"/g" "${ADBC_DIR}/docs/source/conf.py"
+ rm "${ADBC_DIR}/docs/source/conf.py.bak"
git add "${ADBC_DIR}/docs/source/conf.py"
pushd "${ADBC_DIR}/java/"
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 54c46cc8a..dba0d6a3b 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -18,6 +18,7 @@
import os
import sys
from pathlib import Path
+from urllib.parse import quote
sys.path.append(str(Path("./ext/sphinx_recipe").resolve()))
sys.path.append(str(Path("./ext").resolve()))
@@ -34,6 +35,8 @@ author = "the Apache Arrow Developers"
release = "23 (dev)"
# Needed to generate version switcher
version = release
+# For linking to latest downloads
+latest_release = "22"
# -- General configuration ---------------------------------------------------
#
https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -76,6 +79,15 @@ def setup(app):
app.connect("missing-reference", on_missing_reference)
+# -- Global substitutions -----------------------------------------------------
+# Note: uses quote because Sphinx will break if `release` has any spaces in it
+rst_prolog = (
+ f".. |source_download| replace::
`apache-arrow-adbc-{quote(latest_release)}.tar.gz
<https://www.apache.org/dyn/closer.lua/arrow/apache-arrow-adbc-{quote(latest_release)}/apache-arrow-adbc-{quote(latest_release)}.tar.gz>`__\n"
# noqa: E501
+ f".. |source_checksum| replace:: `checksum
<https://downloads.apache.org/arrow/apache-arrow-adbc-{quote(latest_release)}/apache-arrow-adbc-{quote(latest_release)}.tar.gz.sha512>`__\n"
# noqa: E501
+ f".. |source_signature| replace:: `signature
<https://downloads.apache.org/arrow/apache-arrow-adbc-{quote(latest_release)}/apache-arrow-adbc-{quote(latest_release)}.tar.gz.asc>`__\n"
# noqa: E501
+)
+
+
# -- Options for autodoc ----------------------------------------------------
try:
diff --git a/docs/source/driver/installation.rst
b/docs/source/driver/installation.rst
index de31e9e21..a74cebe13 100644
--- a/docs/source/driver/installation.rst
+++ b/docs/source/driver/installation.rst
@@ -26,11 +26,15 @@ Installation
Source
======
-The latest source release can be downloaded from the `Apache mirrors`_.
+Download the latest source release: |source_download| (|source_checksum|,
|source_signature|)
+
+To verify a release, please see the `instructions`_ page and the project's
`KEYS`_ file.
+
Compilation instructions can be found in `CONTRIBUTING.md`_.
-.. _Apache mirrors: https://www.apache.org/dyn/closer.lua/arrow/
.. _CONTRIBUTING.md:
https://github.com/apache/arrow-adbc/blob/main/CONTRIBUTING.md
+.. _instructions: https://www.apache.org/info/verification.html
+.. _KEYS: https://downloads.apache.org/arrow/KEYS
C/C++
=====
