docs: Publish 0.11.0 user guide (#2589)

Author: andygrove

dev/release/README.md

@@ -150,6 +150,24 @@ git push apache 0.1.0-rc1
 Note that pushing a release candidate tag will trigger a GitHub workflow that will build a Docker image and publish
 it to GitHub Container Registry at https://github.com/apache/datafusion-comet/pkgs/container/datafusion-comet
 
+### Publishing Documentation
+
+In `docs` directory:
+
+- Update `docs/source/index.rst` and add a new navigation menu link for the new release in the section `_toc.user-guide-links-versioned`
+- Add a new line to `build.sh` to delete the locally cloned `comet-*` branch for the new release e.g. `comet-0.11`
+- Update the main method in `generate-versions.py`:
+
+```python
+    latest_released_version = "0.11.0"
+    previous_versions = ["0.8.0", "0.9.1", "0.10.1"]
+```
+
+Test the documentation build locally, following the instructions in `docs/README.md`.
+
+Note that the download links in the installation guide will not work until the release is finalized, but having the
+documentation available could be useful for anyone testing out the release candidate during the voting period.
+
 ## Publishing the Release Candidate
 
 This part of the process can mostly only be performed by a PMC member.

docs/build.sh

@@ -28,6 +28,7 @@ cp -rf source/* temp/
 rm -rf comet-0.8
 rm -rf comet-0.9
 rm -rf comet-0.10
+rm -rf comet-0.11
 python3 generate-versions.py
 
 # Remove overview pages (this used to be part of the user guide but is now a top level page)

docs/generate-versions.py

@@ -104,6 +104,6 @@ def generate_docs(snapshot_version: str, latest_released_version: str, previous_
 if __name__ == "__main__":
     print("Generating versioned user guide docs...")
     snapshot_version = get_version_from_pom()
-    latest_released_version = "0.10.0"
-    previous_versions = ["0.8.0", "0.9.1"]
+    latest_released_version = "0.11.0"
+    previous_versions = ["0.8.0", "0.9.1", "0.10.1"]
     generate_docs(snapshot_version, latest_released_version, previous_versions)

docs/source/index.rst

@@ -50,6 +50,7 @@ as a native runtime to achieve improvement in terms of query efficiency and quer
    :hidden:
 
    0.12.0-SNAPSHOT <user-guide/latest/index>
+   0.11.x <user-guide/0.11/index>
    0.10.x <user-guide/0.10/index>
    0.9.x <user-guide/0.9/index>
    0.8.x <user-guide/0.8/index>

docs/source/user-guide/latest/installation.md

@@ -59,12 +59,15 @@ Cloud Service Providers.
 Comet jar files are available in [Maven Central](https://central.sonatype.com/namespace/org.apache.datafusion) for amd64 and arm64 architectures for Linux. For Apple macOS, it
 is currently necessary to build from source.
 
-Here are the direct links for downloading the Comet 0.10.0 jar file.
-
-- [Comet plugin for Spark 3.4 / Scala 2.12](https://repo1.maven.org/maven2/org/apache/datafusion/comet-spark-spark3.4_2.12/0.10.0/comet-spark-spark3.4_2.12-0.10.0.jar)
-- [Comet plugin for Spark 3.4 / Scala 2.13](https://repo1.maven.org/maven2/org/apache/datafusion/comet-spark-spark3.4_2.13/0.10.0/comet-spark-spark3.4_2.13-0.10.0.jar)
-- [Comet plugin for Spark 3.5 / Scala 2.12](https://repo1.maven.org/maven2/org/apache/datafusion/comet-spark-spark3.5_2.12/0.10.0/comet-spark-spark3.5_2.12-0.10.0.jar)
-- [Comet plugin for Spark 3.5 / Scala 2.13](https://repo1.maven.org/maven2/org/apache/datafusion/comet-spark-spark3.5_2.13/0.10.0/comet-spark-spark3.5_2.13-0.10.0.jar)
+Here are the direct links for downloading the Comet $COMET_VERSION jar file. Note that these links are not valid if
+you are viewing the documentation for the latest `SNAPSHOT` release, or for the latest release while it is still going
+through the release vote. Release candidate jars can be found [here](https://repository.apache.org/#nexus-search;quick~org.apache.datafusion).
+
+- [Comet plugin for Spark 3.4 / Scala 2.12](https://repo1.maven.org/maven2/org/apache/datafusion/comet-spark-spark3.4_2.12/$COMET_VERSION/comet-spark-spark3.4_2.12-$COMET_VERSION.jar)
+- [Comet plugin for Spark 3.4 / Scala 2.13](https://repo1.maven.org/maven2/org/apache/datafusion/comet-spark-spark3.4_2.13/$COMET_VERSION/comet-spark-spark3.4_2.13-$COMET_VERSION.jar)
+- [Comet plugin for Spark 3.5 / Scala 2.12](https://repo1.maven.org/maven2/org/apache/datafusion/comet-spark-spark3.5_2.12/$COMET_VERSION/comet-spark-spark3.5_2.12-$COMET_VERSION.jar)
+- [Comet plugin for Spark 3.5 / Scala 2.13](https://repo1.maven.org/maven2/org/apache/datafusion/comet-spark-spark3.5_2.13/$COMET_VERSION/comet-spark-spark3.5_2.13-$COMET_VERSION.jar)
+- [Comet plugin for Spark 4.0 / Scala 2.13 (Experimental)](https://repo1.maven.org/maven2/org/apache/datafusion/comet-spark-spark4.0_2.13/$COMET_VERSION/comet-spark-spark4.0_2.13-$COMET_VERSION.jar)
 
 ## Building from source