Added a changelog (#102)

Author: TomAugspurger

docs/usage.md

@@ -41,7 +41,9 @@ Use [`stac_table_to_ndjson`][stac_geoparquet.arrow.stac_table_to_ndjson] to conv
 
 ## Parquet
 
-Use [`to_parquet`][stac_geoparquet.arrow.to_parquet] to write STAC Arrow data from memory to a path or file-like object. This is a special function to ensure that [GeoParquet](https://geoparquet.org/) 1.0 or 1.1 metadata is written to the Parquet file.
+Use [`to_parquet`][stac_geoparquet.arrow.to_parquet] to write STAC Arrow data from memory to a path or file-like object. This is a special function to ensure that [GeoParquet](https://geoparquet.org/) 1.0 or 1.1 metadata is written to the Parquet file. Additionally, file metadata following the [STAC GeoParquet Specification][spec].
+
+Use the `collection_metadata` keyword to include STAC Collection metadata in the Parquet metadata.
 
 [`parse_stac_ndjson_to_parquet`][stac_geoparquet.arrow.parse_stac_ndjson_to_parquet] is a helper that connects reading (newline-delimited) JSON on disk to writing out to a Parquet file.
 
@@ -65,3 +67,6 @@ No special API is required for reading a STAC Delta Lake table back into Arrow.
     This means we cannot write this collection to Delta Lake **solely with automatic schema inference**.
 
     In such cases, users may need to manually update the inferred schema to cast any `null` type to another Delta Lake-compatible type.
+
+
+[spec]: https://github.com/stac-utils/stac-geoparquet/blob/main/spec/stac-geoparquet-spec.md#parquet-metadata

docs/whatsnew.md

@@ -0,0 +1,12 @@
+# Release Notes
+
+This is a list of changes to `stac-geoparquet`.
+
+## 0.7.0
+
+- Updated stac-geoparquet Parquet File metadata fields (https://github.com/stac-utils/stac-geoparquet/pull/98)
+    - All fields are placed under the `stac-geoparquet` key in the parquet file metadata.
+    - Added a `version` field.
+    - Added json-schema for the metadata parquet file metadata.
+- Fixed `ValueError` when converting some strings to dates (https://github.com/stac-utils/stac-geoparquet/issues/79)
+- Removed upper bound on pyarrow dependency (https://github.com/stac-utils/stac-geoparquet/pull/102)

mkdocs.yml

@@ -26,6 +26,7 @@ nav:
       - Legacy: api/legacy.md
       - api/pgstac.md
   - drawbacks.md
+  - Release Notes: whatsnew.md
 
 watch:
   - stac_geoparquet

pyproject.toml

@@ -17,8 +17,8 @@ dependencies = [
     "packaging",
     "pandas",
     # Needed for RecordBatch.append_column
-    # Below 19 b/c https://github.com/apache/arrow/issues/45283
-    "pyarrow>=16,<19",
+    # !=19.0.0 b/c https://github.com/apache/arrow/issues/45283
+    "pyarrow>=16,!=19.0.0",
     "pyproj",
     "pystac",
     "shapely",