Next release prep (#768)

### Change list

- Docs updates
- README updates
- Update `geometry_col` to work on RecordBatch as well

Author: kylebarron

README.md

@@ -11,23 +11,19 @@ This repository also includes [Python bindings](https://github.com/geoarrow/geoa
 
 ## Documentation
 
+[**Documentation Website**](https://geoarrow.org/geoarrow-rs/)
+
+<!--
 - [Use from Rust](https://docs.rs/geoarrow/latest/geoarrow/)
-- [Use from Python](https://geoarrow.github.io/geoarrow-rs/python)
-- [Use from JavaScript](https://geoarrow.github.io/geoarrow-rs/js)
-- [Create your own Rust-JavaScript library with `wasm-bindgen`](https://docs.rs/geoarrow-wasm/latest/geoarrow_wasm/)
+- [Use from Python](https://geoarrow.org/geoarrow-rs/python)
+- [Use from JavaScript](https://geoarrow.org/geoarrow-rs/js)
+- [Create your own Rust-JavaScript library with `wasm-bindgen`](https://docs.rs/geoarrow-wasm/latest/geoarrow_wasm/) -->
+<!-- - [Create your own Rust-Python library with `pyo3-geoarrow`](https://docs.rs/geoarrow-wasm/latest/geoarrow_wasm/) -->
 
 ## Examples
 
 - [Rust examples](examples/README.md)
 
-## Install
-
-Add this to your `Cargo.toml`:
-
-```toml
-geoarrow = "0.2"
-```
-
 ## References
 
 - [Prototyping GeoRust + GeoArrow in WebAssembly](https://observablehq.com/@kylebarron/prototyping-georust-geoarrow-in-webassembly) gives an early preview of the JavaScript API.

python/README.md

@@ -2,24 +2,42 @@
 
 [![GitHub Workflow Status (Python)](https://img.shields.io/github/actions/workflow/status/geoarrow/geoarrow-rs/python.yml?branch=main)](https://github.com/geoarrow/geoarrow-rs/actions/workflows/python.yml)
 
-This folder contains Python bindings to the [GeoArrow Rust implementation](https://github.com/geoarrow/geoarrow-rs).
+Python bindings to the [GeoArrow Rust implementation](https://github.com/geoarrow/geoarrow-rs).
 
-`geoarrow.rust` is distributed with [namespace packaging](https://packaging.python.org/en/latest/guides/packaging-namespace-packages/), meaning that each python package `geoarrow-rust-[submodule-name]` (imported as `geoarrow.rust.[submodule-name]`) can be published to PyPI independently. The benefit of this approach is that complex C dependencies can be built and packaged independently.
+## Overview
 
-Modules so far:
+This library contains Python bindings to the [GeoArrow Rust implementation](https://github.com/geoarrow/geoarrow-rs).
 
-- [`core`](./core/README.md): All algorithms and data structures implemented in pure Rust without any C dependencies. Having a pure Rust dependency tree means it's trivial to build binary wheels for many operating system architectures that might not be possible with C dependencies.
-- [`io`](./io/README.md): Pure-rust readers and writers for geospatial file formats.
+- **Fast**: Connects to algorithms implemented in [GeoRust](https://georust.org/), which compile to native code.
+- **Parallel**: Multi-threading is enabled out-of-the-box for all operations on chunked data structures.
+- **Self-contained**: `pyproj` is the only Python dependency.
+- **Easy to install**: Distributed as static binary wheels with zero C dependencies.
+- **Static typing**: type hints for all operations.
+- **Interoperable ecosystem**: Efficient data exchange with other libraries in the Python Arrow and GeoArrow ecosystems. , such as [geoarrow-c](https://github.com/geoarrow/geoarrow-c/tree/main/python) or [lightning-fast map rendering](https://github.com/developmentseed/lonboard).
 
-Future potential modules:
+## Documentation
+
+Refer to the [documentation website](https://geoarrow.org/geoarrow-rs/python).
+
+## Modules
+
+`geoarrow.rust` is distributed with [namespace packaging](https://packaging.python.org/en/latest/guides/packaging-namespace-packages/), meaning that each Python submodule is published to PyPI independently. This allows for separation of concerns and smaller environments when only some portion of functionality is necessary.
 
-- `geos`: [GEOS](https://libgeos.org/)-based algorithms on GeoArrow memory.
-- `proj`: [PROJ](https://proj.org/en/9.3/)-based coordinate reprojection on GeoArrow memory.
+Existing modules:
+
+- `geoarrow-rust-core`: Data structures to store and manage geometry data in GeoArrow format.
+- `geoarrow-rust-compute`: Compute operations on GeoArrow data.
+- `geoarrow-rust-io`: Pure-rust readers and writers for geospatial file formats.
 
 In order to obtain relevant modules, you should install them from PyPI directly, e.g.:
 
 ```
-pip install geoarrow-rust-core
+pip install geoarrow-rust-core geoarrow-rust-compute geoarrow-rust-io
 ```
 
-See [DEVELOP.md](docs/DEVELOP.md) in the `docs` folder for more information on developing and building the Python bindings.
+Future potential modules:
+
+- `geoarrow-rust-geos`: [GEOS](https://libgeos.org/)-based algorithms on GeoArrow memory.
+- `geoarrow-rust-proj`: [PROJ](https://proj.org/en/9.3/)-based coordinate reprojection on GeoArrow memory.
+
+See [DEVELOP.md](DEVELOP.md) for more information on developing and building the Python bindings.

python/docs/api/compute/enums.md

@@ -0,0 +1,3 @@
+# Enums
+
+::: geoarrow.rust.compute.enums

python/docs/api/compute/functions.md

@@ -0,0 +1,40 @@
+# Functions
+
+## Array/Chunked Array functions
+
+::: geoarrow.rust.compute
+    options:
+      filters:
+        - "!^_"
+      members:
+        - affine_transform
+        - area
+        - center
+        - centroid
+        - chaikin_smoothing
+        - convex_hull
+        - densify
+        - envelope
+        - frechet_distance
+        - geodesic_perimeter
+        - is_empty
+        - length
+        - line_interpolate_point
+        - line_locate_point
+        - polylabel
+        - rotate
+        - scale
+        - signed_area
+        - simplify
+        - skew
+        - total_bounds
+        - translate
+
+## Table functions
+
+::: geoarrow.rust.compute
+    options:
+      filters:
+        - "!^_"
+      members:
+        - explode

python/docs/api/compute/types.md

@@ -0,0 +1,3 @@
+# Types
+
+::: geoarrow.rust.compute.types

python/docs/api/core/functions.md

@@ -1,34 +1,21 @@
-# Top-level functions
+# Functions
 
-## Array/Chunked Array functions
+Interoperability with other Python geospatial libraries (Shapely, GeoPandas) and in-memory geospatial formats (WKB, WKT).
 
 ::: geoarrow.rust.core
     options:
       filters:
         - "!^_"
       members:
-        - affine_transform
-        - area
-        - center
-        - centroid
-        - chaikin_smoothing
-        - convex_hull
-        - densify
-        - envelope
-        - frechet_distance
-        - geodesic_perimeter
-        - is_empty
-        - length
-        - line_interpolate_point
-        - line_locate_point
-        - polylabel
-        - rotate
-        - scale
-        - signed_area
-        - simplify
-        - skew
-        - total_bounds
-        - translate
+        - read_pyogrio
+        - from_ewkb
+        - from_geopandas
+        - from_shapely
+        - from_wkb
+        - from_wkt
+        - to_geopandas
+        - to_shapely
+        - to_wkb
 
 ## Table functions
 
@@ -37,5 +24,4 @@
       filters:
         - "!^_"
       members:
-        - explode
         - geometry_col

python/docs/api/core/interop.md

@@ -1,4 +1,4 @@
-# I/O
+# Functions
 
 Read and write to and from geospatial file formats.
 

python/docs/api/io/io.md renamed to python/docs/api/io/functions.md

@@ -10,5 +10,4 @@ from geoarrow.rust.core import read_pyogrio, geometry_col
 path = "path/to/file.shp"
 table = read_pyogrio(path)
 geometry = geometry_col(table)
-# <geoarrow.rust.core._rust.ChunkedMultiLineStringArray at 0x13fb61e70>
 ```