Add pgstac page

README.md

@@ -12,12 +12,6 @@ For analytic questions like "find the items in the Sentinel-2 collection in June
 
 See the [STAC-GeoParquet specification](./spec/stac-geoparquet-spec.md) for details on the exact schema of the written Parquet files.
 
+## Documentation
 
-<!--
-## pgstac integration
-
-`stac_geoparquet.pgstac_reader` has some helpers for working with items coming from a `pgstac.items` table. It takes care of
-
-- Rehydrating the dehydrated items
-- Partitioning by time
-- Injecting dynamic links and assets from a STAC API -->
+[Documentation website](https://stac-utils.github.io/stac-geoparquet/)

docs/api/pgstac.md

@@ -0,0 +1,11 @@
+# pgstac integration
+
+`stac_geoparquet.pgstac_reader` has some helpers for working with items coming from a `pgstac.items` table. It takes care of
+
+- Rehydrating the dehydrated items
+- Partitioning by time
+- Injecting dynamic links and assets from a STAC API
+
+::: stac_geoparquet.pgstac_reader.CollectionConfig
+    options:
+        show_if_no_docstring: true

mkdocs.yml

@@ -22,7 +22,7 @@ nav:
   - API Reference:
       - api/arrow.md
       - Legacy: api/legacy.md
-      # - api/pgstac.md
+      - api/pgstac.md
   - drawbacks.md
 
 watch:

stac_geoparquet/pgstac_reader.py

@@ -284,13 +284,12 @@ def make_pgstac_items(
         """
         Make STAC items out of pgstac records.
 
-        Parameters
-        ----------
-        records: list[tuple]
-            The dehydrated records from pgstac.items table.
-        base_item: dict[str, Any]
-            The base item from the ``collection_base_item`` pgstac function for this
-            collection. Used for rehydration
+        Args:
+            records: list[tuple]
+                The dehydrated records from pgstac.items table.
+            base_item: dict[str, Any]
+                The base item from the ``collection_base_item`` pgstac function for this
+                collection. Used for rehydration
         """
         columns = [
             "id",