Add nested toctree grouping to top-level Python docs

Desel72 · Desel72 · commit e099b531a38b · 2026-03-19T15:06:13.000Z
diff --git a/docs/source/python/data_and_compute.rst b/docs/source/python/data_and_compute.rst
@@ -0,0 +1,27 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements.  See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership.  The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License.  You may obtain a copy of the License at
+
+..   http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied.  See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Data and Compute
+================
+
+.. toctree::
+   :maxdepth: 2
+
+   data
+   compute
+   memory
+   timestamps
diff --git a/docs/source/python/data_interchange.rst b/docs/source/python/data_interchange.rst
@@ -0,0 +1,28 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements.  See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership.  The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License.  You may obtain a copy of the License at
+
+..   http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied.  See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Data Interchange
+================
+
+.. toctree::
+   :maxdepth: 2
+
+   numpy
+   pandas
+   interchange_protocol
+   dlpack
+   extending_types
diff --git a/docs/source/python/file_formats.rst b/docs/source/python/file_formats.rst
@@ -0,0 +1,32 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements.  See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership.  The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License.  You may obtain a copy of the License at
+
+..   http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied.  See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+File Formats and I/O
+=====================
+
+.. toctree::
+   :maxdepth: 2
+
+   ipc
+   filesystems
+   csv
+   feather
+   json
+   orc
+   parquet
+   dataset
+   flight
diff --git a/docs/source/python/getting_started_guide.rst b/docs/source/python/getting_started_guide.rst
@@ -0,0 +1,25 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements.  See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership.  The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License.  You may obtain a copy of the License at
+
+..   http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied.  See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Getting Started
+===============
+
+.. toctree::
+   :maxdepth: 2
+
+   install
+   getstarted
diff --git a/docs/source/python/index.rst b/docs/source/python/index.rst
@@ -41,30 +41,13 @@ libraries that add additional functionality such as reading Apache Parquet
 files into Arrow structures.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 3
 
-   install
-   getstarted
-   data
-   compute
-   memory
-   ipc
-   filesystems
-   numpy
-   pandas
-   interchange_protocol
-   dlpack
-   timestamps
-   orc
-   csv
-   feather
-   json
-   parquet
-   dataset
-   flight
-   extending_types
+   getting_started_guide
+   data_and_compute
+   file_formats
+   data_interchange
    integration
-   env_vars
-   api
+   reference
    getting_involved
    Python cookbook <https://arrow.apache.org/cookbook/py/>
diff --git a/docs/source/python/reference.rst b/docs/source/python/reference.rst
@@ -0,0 +1,25 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+.. or more contributor license agreements.  See the NOTICE file
+.. distributed with this work for additional information
+.. regarding copyright ownership.  The ASF licenses this file
+.. to you under the Apache License, Version 2.0 (the
+.. "License"); you may not use this file except in compliance
+.. with the License.  You may obtain a copy of the License at
+
+..   http://www.apache.org/licenses/LICENSE-2.0
+
+.. Unless required by applicable law or agreed to in writing,
+.. software distributed under the License is distributed on an
+.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+.. KIND, either express or implied.  See the License for the
+.. specific language governing permissions and limitations
+.. under the License.
+
+Reference
+=========
+
+.. toctree::
+   :maxdepth: 2
+
+   env_vars
+   api
