remove: specficiation documents (#120)

* remove: specficiation documents

* fix: skip vcr tests for python 3.9

Author: gadomski

.github/workflows/continuous-integration.yml

@@ -33,5 +33,3 @@ jobs:
         run: uv run pytest tests -v
       - name: Check docs
         run: uv run mkdocs build --strict
-      - name: Check jsonschema
-        run: check-jsonschema --schemafile spec/json-schema/metadata.json spec/example-metadata.json

README.md

@@ -14,8 +14,7 @@ While STAC Items are commonly distributed as individual JSON files on object sto
 
 For analytic questions like "find the items in the Sentinel-2 collection in June 2024 over New York City with cloud cover of less than 20%" it can be much, much faster to find the relevant data from a GeoParquet source than from JSON, because GeoParquet needs to load only the relevant columns for that query, not the full data.
 
-See the [STAC-GeoParquet specification](./spec/stac-geoparquet-spec.md) for details on the exact schema of the written Parquet files.
-
+See the [STAC-GeoParquet specification](https://radiantearth.github.io/stac-geoparquet-spec/) for details on the exact schema of the written Parquet files.
 
 ## Installation
 
@@ -40,9 +39,3 @@ uv run pre-commit install
 uv run pytest
 scripts/lint
 ```
-
-Validate the example collection metadata against the jsonschema:
-
-```shell
-check-jsonschema --schemafile spec/json-schema/metadata.json spec/example-metadata.json
-```

docs/drawbacks.md

@@ -17,16 +17,13 @@ extra:
 nav:
   - index.md
   - usage.md
-  - schema.md
   - Examples:
       - examples/naip.ipynb
       - examples/dump_pgstac_to_parquet.ipynb
-  - Specification: spec/stac-geoparquet-spec.md
   - API Reference:
       - api/arrow.md
       - Legacy: api/legacy.md
       - api/pgstac.md
-  - drawbacks.md
   - Release Notes: whatsnew.md
 
 watch:
@@ -109,6 +106,11 @@ plugins:
             - https://pandas.pydata.org/pandas-docs/stable/objects.inv
             - https://pystac.readthedocs.io/en/stable/objects.inv
             - https://shapely.readthedocs.io/en/stable/objects.inv
+  - redirects:
+      redirect_maps:
+        "spec/stac-geoparquet-spec.md": "https://radiantearth.github.io/stac-geoparquet-spec/latest/"
+        "drawbacks.md": "https://radiantearth.github.io/stac-geoparquet-spec/latest/drawbacks/"
+        "schema.md": "https://radiantearth.github.io/stac-geoparquet-spec/latest/schema/"
 
 # https://github.com/developmentseed/titiler/blob/50934c929cca2fa8d3c408d239015f8da429c6a8/docs/mkdocs.yml#L115-L140
 markdown_extensions:

docs/schema.md

@@ -62,6 +62,7 @@ docs = [
     "mkdocs-material[imaging]>=9.5",
     "mkdocs",
     "mkdocstrings[python]>=0.25.1",
+    "mkdocs-redirects>=1.2.2",
 ]
 
 [tool.uv]