This is an automated email from the ASF dual-hosted git repository.
kabhwan pushed a commit to branch branch-3.5
in repository https://gitbox.apache.org/repos/asf/spark.git
The following commit(s) were added to refs/heads/branch-3.5 by this push:
new 850ec0b4adcb [SPARK-47299][PYTHON][DOCS] Use the same `versions.json`
in the dropdown of different versions of PySpark documents
850ec0b4adcb is described below
commit 850ec0b4adcb219d048bed003a7cb42cfc731f33
Author: panbingkun <panbing...@baidu.com>
AuthorDate: Mon Apr 8 10:19:26 2024 +0900
[SPARK-47299][PYTHON][DOCS] Use the same `versions.json` in the dropdown of
different versions of PySpark documents
### What changes were proposed in this pull request?
The pr aims to use the same `versions.json` in the dropdown of `different
versions` of PySpark documents.
### Why are the changes needed?
As discussed in the email group, using this approach can avoid `maintenance
difficulties` and `inconsistencies` that may arise when `multi active release
version lines` are released in the future.
<img width="798" alt="image"
src="https://github.com/apache/spark/assets/15246973/8a08a4fe-e1fb-4334-a3f9-c6dffb01cbd6";>
### Does this PR introduce _any_ user-facing change?
Yes, only for pyspark docs.
### How was this patch tested?
- Manually test.
- Pass GA.
### Was this patch authored or co-authored using generative AI tooling?
No.
Closes #45400 from panbingkun/SPARK-47299.
Authored-by: panbingkun <panbing...@baidu.com>
Signed-off-by: Jungtaek Lim <kabhwan.opensou...@gmail.com>
(cherry picked from commit b299b2bc06a91db630ab39b9c35663342931bb56)
Signed-off-by: Jungtaek Lim <kabhwan.opensou...@gmail.com>
---
python/docs/source/_static/versions.json | 22 ----------------------
python/docs/source/conf.py | 6 +++++-
2 files changed, 5 insertions(+), 23 deletions(-)
diff --git a/python/docs/source/_static/versions.json
b/python/docs/source/_static/versions.json
deleted file mode 100644
index 3d0bd1481806..000000000000
--- a/python/docs/source/_static/versions.json
+++ /dev/null
@@ -1,22 +0,0 @@
-[
- {
- "name": "3.4.1",
- "version": "3.4.1"
- },
- {
- "name": "3.4.0",
- "version": "3.4.0"
- },
- {
- "name": "3.3.2",
- "version": "3.3.2"
- },
- {
- "name": "3.3.1",
- "version": "3.3.1"
- },
- {
- "name": "3.3.0",
- "version": "3.3.0"
- }
-]
diff --git a/python/docs/source/conf.py b/python/docs/source/conf.py
index 08a25c5dd071..1b5cf3474465 100644
--- a/python/docs/source/conf.py
+++ b/python/docs/source/conf.py
@@ -182,7 +182,11 @@ autosummary_generate = True
html_theme = 'pydata_sphinx_theme'
html_context = {
- "switcher_json_url": "_static/versions.json",
+ # When releasing a new Spark version, please update the file
+ # "site/static/versions.json" under the code repository "spark-website"
+ # (item should be added in order), and also set the local environment
+ # variable "RELEASE_VERSION".
+ "switcher_json_url": "https://spark.apache.org/static/versions.json";,
"switcher_template_url":
"https://spark.apache.org/docs/{version}/api/python/index.html";,
}
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@spark.apache.org
For additional commands, e-mail: commits-h...@spark.apache.org
