misc minor updates

py-polars/docs/source/reference/index.rst

@@ -3,7 +3,7 @@ Python API reference
 ====================
 
 This page gives a high-level overview of all public Polars objects, functions and
-methods. All classes and functions exposed in ``polars.*`` namespace are public.
+methods. All classes and functions exposed in the ``polars.*`` namespace are public.
 
 
 .. grid::

py-polars/docs/source/reference/io.rst

@@ -3,6 +3,14 @@ Input/output
 ============
 .. currentmodule:: polars
 
+Avro
+~~~~
+.. autosummary::
+   :toctree: api/
+
+   read_avro
+   DataFrame.write_avro
+
 CSV
 ~~~
 .. autosummary::
@@ -14,29 +22,14 @@ CSV
    DataFrame.write_csv
    LazyFrame.sink_csv
 
-Feather/ IPC
-~~~~~~~~~~~~
-.. autosummary::
-   :toctree: api/
-
-   read_ipc
-   read_ipc_stream
-   scan_ipc
-   read_ipc_schema
-   DataFrame.write_ipc
-   DataFrame.write_ipc_stream
-   LazyFrame.sink_ipc
+.. currentmodule:: polars.io.csv.batched_reader
 
-Parquet
-~~~~~~~
 .. autosummary::
    :toctree: api/
 
-   read_parquet
-   scan_parquet
-   read_parquet_schema
-   DataFrame.write_parquet
-   LazyFrame.sink_parquet
+    BatchedCsvReader.next_batches
+
+.. currentmodule:: polars
 
 Database
 ~~~~~~~~
@@ -47,27 +40,16 @@ Database
    read_database_uri
    DataFrame.write_database
 
-JSON
-~~~~
-.. autosummary::
-   :toctree: api/
-
-   read_json
-   read_ndjson
-   scan_ndjson
-   DataFrame.write_json
-   DataFrame.write_ndjson
-   LazyFrame.sink_ndjson
-
-AVRO
-~~~~
+Delta Lake
+~~~~~~~~~~
 .. autosummary::
    :toctree: api/
 
-   read_avro
-   DataFrame.write_avro
+   scan_delta
+   read_delta
+   DataFrame.write_delta
 
-Spreadsheet
+Excel / ODS
 ~~~~~~~~~~~
 .. autosummary::
    :toctree: api/
@@ -76,39 +58,54 @@ Spreadsheet
    read_ods
    DataFrame.write_excel
 
-Apache Iceberg
-~~~~~~~~~~~~~~
+Feather / IPC
+~~~~~~~~~~~~~
 .. autosummary::
    :toctree: api/
 
-   scan_iceberg
+   read_ipc
+   read_ipc_stream
+   scan_ipc
+   read_ipc_schema
+   DataFrame.write_ipc
+   DataFrame.write_ipc_stream
+   LazyFrame.sink_ipc
 
-Delta Lake
-~~~~~~~~~~
+Iceberg
+~~~~~~~
 .. autosummary::
    :toctree: api/
 
-   scan_delta
-   read_delta
-   DataFrame.write_delta
-
-Datasets
-~~~~~~~~
-Connect to pyarrow datasets.
+   scan_iceberg
 
+JSON
+~~~~
 .. autosummary::
    :toctree: api/
 
-   scan_pyarrow_dataset
+   read_json
+   read_ndjson
+   scan_ndjson
+   DataFrame.write_json
+   DataFrame.write_ndjson
+   LazyFrame.sink_ndjson
+
+Parquet
+~~~~~~~
+.. autosummary::
+   :toctree: api/
 
+   read_parquet
+   scan_parquet
+   read_parquet_schema
+   DataFrame.write_parquet
+   LazyFrame.sink_parquet
 
-BatchedCsvReader
+PyArrow Datasets
 ~~~~~~~~~~~~~~~~
-This reader comes available by calling `pl.read_csv_batched`.
-
-.. currentmodule:: polars.io.csv.batched_reader
+Connect to pyarrow datasets.
 
 .. autosummary::
    :toctree: api/
 
-    BatchedCsvReader.next_batches
+   scan_pyarrow_dataset