apache · andygrove · Apr 23, 2026 · Apr 23, 2026 · Apr 23, 2026 · Apr 23, 2026
diff --git a/docs/source/about/gluten_comparison.md b/docs/source/about/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]: /user-guide/latest/compatibility.md
+[Comet Compatibility Guide]: /user-guide/latest/compatibility/index.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.

diff --git a/docs/source/contributor-guide/adding_a_new_operator.md b/docs/source/contributor-guide/adding_a_new_operator.md
@@ -414,7 +414,7 @@ mod tests {
 
 ### Step 7: Update Documentation
 
-Add your operator to the supported operators list in `docs/source/user-guide/latest/compatibility.md` or similar documentation.
+Add your operator to the supported operators list in `docs/source/user-guide/latest/compatibility/operators.md` or similar documentation.
 
 ## Implementing a Sink Operator
 

diff --git a/docs/source/contributor-guide/index.md b/docs/source/contributor-guide/index.md
@@ -28,7 +28,6 @@ Comet Plugin Overview <plugin_overview>
 Arrow FFI <ffi>
 JVM Shuffle <jvm_shuffle>
 Native Shuffle <native_shuffle>
-Parquet Scans <parquet_scans>
 Development Guide <development>
 Debugging Guide <debugging>
 Benchmarking Guide <benchmarking>

diff --git a/docs/source/contributor-guide/parquet_scans.md b/docs/source/contributor-guide/parquet_scans.md
diff --git a/docs/source/user-guide/latest/compatibility.md b/docs/source/user-guide/latest/compatibility.md