fix docs warnings (apache#2320)

Author: andygrove

docs/source/contributor-guide/development.md

@@ -30,7 +30,7 @@ under the License.
 
 ## Development Setup
 
-1. Make sure `JAVA_HOME` is set and point to JDK using [support matrix](/docs/source/user-guide/latest/installation.md)
+1. Make sure `JAVA_HOME` is set and point to JDK using [support matrix](../user-guide/latest/installation.md)
 2. Install Rust toolchain. The easiest way is to use
    [rustup](https://rustup.rs).
 

docs/source/contributor-guide/plugin_overview.md

@@ -147,4 +147,4 @@ accessing Arrow data structures from multiple languages.
 
 The following diagram shows an example of the end-to-end flow for a query stage.
 
-![Diagram of Comet Data Flow](../../_static/images/comet-dataflow.svg)
+![Diagram of Comet Data Flow](/_static/images/comet-dataflow.svg)

docs/source/contributor-guide/spark-sql-tests.md

@@ -54,7 +54,7 @@ git apply ../datafusion-comet/dev/diffs/3.4.3.diff
 
 ## 3. Run Spark SQL Tests
 
-#### Use the following commands to run the Spark SQL test suite locally.
+### Use the following commands to run the Spark SQL test suite locally.
 
 ```shell
 ENABLE_COMET=true build/sbt catalyst/test
@@ -65,7 +65,7 @@ ENABLE_COMET=true build/sbt "hive/testOnly * -- -l org.apache.spark.tags.Extende
 ENABLE_COMET=true build/sbt "hive/testOnly * -- -n org.apache.spark.tags.ExtendedHiveTest"
 ENABLE_COMET=true build/sbt "hive/testOnly * -- -n org.apache.spark.tags.SlowHiveTest"
 ```
-#### Steps to run individual test suites through SBT
+### Steps to run individual test suites through SBT
 1. Open SBT with Comet enabled
 ```shell
 ENABLE_COMET=true sbt -J-Xmx4096m -Dspark.test.includeSlowTests=true 
@@ -74,7 +74,7 @@ ENABLE_COMET=true sbt -J-Xmx4096m -Dspark.test.includeSlowTests=true
 ```shell
  sql/testOnly  org.apache.spark.sql.DynamicPartitionPruningV1SuiteAEOn -- -z "SPARK-35568"
 ```
-#### Steps to run individual test suites in IntelliJ IDE
+### Steps to run individual test suites in IntelliJ IDE
 1. Add below configuration in VM Options for your test case (apache-spark repository)
 ```shell
 -Dspark.comet.enabled=true -Dspark.comet.debug.enabled=true -Dspark.plugins=org.apache.spark.CometPlugin -DXmx4096m -Dspark.executor.heartbeatInterval=20000 -Dspark.network.timeout=10000 --add-exports=java.base/sun.nio.ch=ALL-UNNAMED --add-opens=java.base/java.nio=ALL-UNNAMED

docs/source/gluten_comparison.md

@@ -64,7 +64,7 @@ Comet relies on the full Spark SQL test suite (consisting of more than 24,000 te
 integration tests to ensure compatibility with Spark. Features that are known to have compatibility differences with
 Spark are disabled by default, but users can opt in. See the [Comet Compatibility Guide] for more information.
 
-[Comet Compatibility Guide]: compatibility.md
+[Comet Compatibility Guide]: user-guide/latest/compatibility.md
 
 Gluten also aims to provide compatibility with Spark, and includes a subset of the Spark SQL tests in its own test
 suite. See the [Gluten Compatibility Guide] for more information.

docs/source/index.rst

@@ -43,7 +43,7 @@ as a native runtime to achieve improvement in terms of query efficiency and quer
    Comet Overview <overview>
    Comparison with Gluten <gluten_comparison>
 
-.. _toc.user-guide-links:
+.. _toc.user-guide-links-versioned:
 .. toctree::
    :maxdepth: 2
    :caption: User Guides:
@@ -52,7 +52,6 @@ as a native runtime to achieve improvement in terms of query efficiency and quer
    Comet 0.10.0-SNAPSHOT <user-guide/latest/index>
    Comet 0.9.x <user-guide/0.9/index>
    Comet 0.8.x <user-guide/0.8/index>
-   Comet 0.7.x <user-guide/0.7/index>
 
 .. _toc.contributor-guide-links:
 .. toctree::

docs/source/overview.md

@@ -62,4 +62,4 @@ hardware.
 
 Refer to the [Comet Installation Guide] to get started.
 
-[Comet Installation Guide]: installation.md
+[Comet Installation Guide]: user-guide/latest/installation.md

docs/source/user-guide/0.8/index.rst

@@ -15,14 +15,14 @@
 .. specific language governing permissions and limitations
 .. under the License.
 
-.. image:: _static/images/DataFusionComet-Logo-Light.png
+.. image:: /_static/images/DataFusionComet-Logo-Light.png
   :alt: DataFusion Comet Logo
 
 =======================
 Comet 0.8.x User Guide
 =======================
 
-.. _toc.user-guide-links:
+.. _toc.user-guide-links-08:
 .. toctree::
    :maxdepth: 1
    :caption: Comet 0.8.x User Guide

docs/source/user-guide/0.9/index.rst

@@ -15,14 +15,14 @@
 .. specific language governing permissions and limitations
 .. under the License.
 
-.. image:: _static/images/DataFusionComet-Logo-Light.png
+.. image:: /_static/images/DataFusionComet-Logo-Light.png
   :alt: DataFusion Comet Logo
 
 =======================
 Comet 0.9.x User Guide
 =======================
 
-.. _toc.user-guide-links:
+.. _toc.user-guide-links-09:
 .. toctree::
    :maxdepth: 1
    :caption: Comet 0.9.x User Guide

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

@@ -122,24 +122,24 @@ Input [3]: [id#0, first_name#1, personal_info#4]
 
 Verify the native scan type should be `CometNativeScan`.
 
-More on [HDFS Reader](../../../native/hdfs/README.md)
+More on [HDFS Reader](https://github.com/apache/datafusion-comet/blob/main/native/hdfs/README.md)
 
 ### Local HDFS development
 
 - Configure local machine network. Add hostname to `/etc/hosts`
-```commandline
+```shell
 127.0.0.1	localhost   namenode datanode1 datanode2 datanode3
 ::1             localhost namenode datanode1 datanode2 datanode3
 ```
 
 - Start local HDFS cluster, 3 datanodes, namenode url is `namenode:9000` 
-```commandline
+```shell
 docker compose -f kube/local/hdfs-docker-compose.yml up
 ```
 
 - Check the local namenode is up and running on `http://localhost:9870/dfshealth.html#tab-overview`
 - Build a project with HDFS support
-```commandline
+```shell
 JAVA_HOME="/opt/homebrew/opt/openjdk@11" make release PROFILES="-Pspark-3.5" COMET_FEATURES=hdfs RUSTFLAGS="-L /opt/homebrew/opt/openjdk@11/libexec/openjdk.jdk/Contents/Home/lib/server"
 ```
 

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

@@ -143,7 +143,7 @@ scala> spark.sql(s"SELECT * from t1").explain()
 ```
 
 ## Known issues
- - We temporarily disable Comet when there are delete files in Iceberg scan, see Iceberg [1.8.1 diff](../../../dev/diffs/iceberg/1.8.1.diff) and this [PR](https://github.com/apache/iceberg/pull/13793)
+ - We temporarily disable Comet when there are delete files in Iceberg scan, see Iceberg [1.8.1 diff](https://github.com/apache/datafusion-comet/blob/main/dev/diffs/iceberg/1.8.1.diff) and this [PR](https://github.com/apache/iceberg/pull/13793)
    - Iceberg scan w/ delete files lead to [runtime exceptions](https://github.com/apache/datafusion-comet/issues/2117) and [incorrect results](https://github.com/apache/datafusion-comet/issues/2118)
  - Enabling `CometShuffleManager` leads to [runtime exceptions](https://github.com/apache/datafusion-comet/issues/2086)
  - Spark Runtime Filtering isn't [working](https://github.com/apache/datafusion-comet/issues/2116)