Docs edit (#358)

* copy edit pass to docs

* nit

* revert access-data link removal

* revert horizontal-scaling-via-spatial-chunking.ipynb

Author: norlandrhagen

docs/access-data.md

@@ -19,18 +19,18 @@ There a few different ways to access the data, in addition to exploration via th
 | Option                            | Description                                                                             | Formats               | Access                                                       | License                                                   | Data sources                                                                                                                                                                                                                                                                                                                                                                                                 |
 | --------------------------------- | --------------------------------------------------------------------------------------- | --------------------- | ------------------------------------------------------------ | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | **Raster (tensor) data**          | Full gridded dataset spanning CONUS                                                     | Icechunk (Zarr-based) | [Source Coop](https://source.coop/carbonplan/carbonplan-ocr) | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) | [K Riley et al. 2025](https://doi.org/10.2737/RDS-2025-0006), [J Scott et al. 2024](https://doi.org/10.2737/RDS-2020-0016-2), [R Rasmussen et al. 2023](https://doi.org/10.1175/BAMS-D-21-0326.1)                                                                                                                                                                                                            |
-| **Vector (polygon) data**           | Full buildings dataset spanning CONUS                                                   | GeoParquet            | [Source Coop](https://source.coop/carbonplan/carbonplan-ocr) | [ODbL](https://opendatacommons.org/licenses/odbl/1-0/)    | [Overture Maps Foundation buildings dataset](https://docs.overturemaps.org/guides/buildings/), [K Riley et al. 2025](https://doi.org/10.2737/RDS-2025-0006), [J Scott et al. 2024](https://doi.org/10.2737/RDS-2020-0016-2), [R Rasmussen et al. 2023](https://doi.org/10.1175/BAMS-D-21-0326.1)                                                                                                             |
+| **Vector (polygon) data**         | Full buildings dataset spanning CONUS                                                   | GeoParquet            | [Source Coop](https://source.coop/carbonplan/carbonplan-ocr) | [ODbL](https://opendatacommons.org/licenses/odbl/1-0/)    | [Overture Maps Foundation buildings dataset](https://docs.overturemaps.org/guides/buildings/), [K Riley et al. 2025](https://doi.org/10.2737/RDS-2025-0006), [J Scott et al. 2024](https://doi.org/10.2737/RDS-2020-0016-2), [R Rasmussen et al. 2023](https://doi.org/10.1175/BAMS-D-21-0326.1)                                                                                                             |
 | **Regional statistics**           | Summary statistics for regions (state, county, census tract, census block) within CONUS | CSV, GeoJSON          | [Source Coop](https://source.coop/carbonplan/carbonplan-ocr) | [ODbL](https://opendatacommons.org/licenses/odbl/1-0/)    | [Census TIGER/Line](https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html), [Overture Maps Foundation buildings dataset](https://docs.overturemaps.org/guides/buildings/), [K Riley et al. 2025](https://doi.org/10.2737/RDS-2025-0006), [J Scott et al. 2024](https://doi.org/10.2737/RDS-2020-0016-2), [R Rasmussen et al. 2023](https://doi.org/10.1175/BAMS-D-21-0326.1) |
 | **Subsetted vector (point) data** | Building-level data subsetted to active region (county, census tract, census block)     | CSV, GeoPackage       | Web tool (see below)                                         | [ODbL](https://opendatacommons.org/licenses/odbl/1-0/)    | [Census TIGER/Line](https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html), [Overture Maps Foundation buildings dataset](https://docs.overturemaps.org/guides/buildings/), [K Riley et al. 2025](https://doi.org/10.2737/RDS-2025-0006), [J Scott et al. 2024](https://doi.org/10.2737/RDS-2020-0016-2), [R Rasmussen et al. 2023](https://doi.org/10.1175/BAMS-D-21-0326.1) |
 
 ## Full dataset downloads
 
 ### Links
 
-| Option                   | Path                                                                                                                                   | Notes                                                                       |
-| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
-| **Raster (tensor) data** | `s3://us-west-2.opendata.source.coop/carbonplan/carbonplan-ocr/output/fire-risk/tensor/production/v1.0.0/ocr.icechunk/`                | See [guide for working with Icehunk data](./how-to/work-with-data.ipynb)    |
-| **Vector (polygon) data**  | `s3://us-west-2.opendata.source.coop/carbonplan/carbonplan-ocr/output/fire-risk/vector/production/v1.0.0/geoparquet/buildings.parquet` | See [guide for working with GeoParquet data](./how-to/work-with-data.ipynb) |
+| Option                    | Path                                                                                                                                   | Notes                                                                       |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| **Raster (tensor) data**  | `s3://us-west-2.opendata.source.coop/carbonplan/carbonplan-ocr/output/fire-risk/tensor/production/v1.0.0/ocr.icechunk/`                | See [guide for working with Icehunk data](./how-to/work-with-data.ipynb)    |
+| **Vector (polygon) data** | `s3://us-west-2.opendata.source.coop/carbonplan/carbonplan-ocr/output/fire-risk/vector/production/v1.0.0/geoparquet/buildings.parquet` | See [guide for working with GeoParquet data](./how-to/work-with-data.ipynb) |
 
 ### Schema
 
@@ -62,7 +62,7 @@ The schemas for each of the full datasets are described on the [data schema](./r
 | `rps_2047_mean`        | float   | Mean annual fire risk (~2047 climate conditions) across all buildings in region                                                                                                                                                    |
 | `bp_2011_mean`         | float   | Mean burn probability (~2011 climate conditions) across all buildings in region                                                                                                                                                    |
 | `bp_2047_mean`         | float   | Mean burn probability (~2047 climate conditions) across all buildings in region                                                                                                                                                    |
-| `crps_scott_mean`      | float   | Mean conditional risk to potential structures (cRPS) from Scott et al., (2024)                                                                                                                                              |
+| `crps_scott_mean`      | float   | Mean conditional risk to potential structures (cRPS) from Scott et al., (2024)                                                                                                                                                     |
 | `bp_2011_riley_mean`   | float   | Mean burn probability (~2011 climate conditions) across all buildings in region from Riley et al., (2025)                                                                                                                          |
 | `bp_2047_riley_mean`   | float   | Mean burn probability (~2047 climate conditions) across all buildings in region from Riley et al., (2025)                                                                                                                          |
 | `rps_2011_median`      | float   | Median annual fire risk (~2011 climate conditions) across all buildings in region                                                                                                                                                  |

docs/reference/data-schema.md

@@ -35,7 +35,7 @@ graph TB
     %% Storage Formats
     subgraph Storage["<b>Storage Formats</b>"]
         Icechunk[("<b>Icechunk</b><br/>Zarr-based<br/>S3-backed<br/>Versioned")]
-        GeoParquet[("<b>GeoParquet</b><br/>zstd compressed<br/>Consolidated<br/>Single file")]
+        GeoParquet[("<b>GeoParquet</b><br/>Hive-partitioned")]
     end
 
     %% Data Flow
@@ -123,8 +123,8 @@ The `wind_direction` coordinate contains 8 direction labels: `['N', 'NE', 'E', '
 
 **Properties:**
 
--   Values sum to 1.0 for all pixels (normalized probability distribution)
--   Derived from CONUS404 data (Rasmussen et al, 2023) using 99th percentile Fosberg Fire Weather Index (FFWI) as threshold
+- Values sum to 1.0 for all pixels (normalized probability distribution)
+- Derived from CONUS404 data (Rasmussen et al, 2023) using 99th percentile Fosberg Fire Weather Index (FFWI) as threshold
 
 ### Data Processing Flow
 
@@ -178,8 +178,8 @@ Vector datasets contain building-level risk samples stored as a consolidated Geo
 
 #### Geometry Column
 
-| Column     | Type        | Description                             |
-| ---------- | ----------- | --------------------------------------- |
+| Column     | Type          | Description                            |
+| ---------- | ------------- | -------------------------------------- |
 | `geometry` | WKB (Polygon) | Building polygon location in EPSG:4326 |
 
 #### Risk Attribute Columns
@@ -210,8 +210,8 @@ Vector datasets contain the same risk variables as raster datasets, sampled at e
 
 ### Data Quality
 
--   Buildings with NaN values (outside CONUS) are excluded
--   Building locations sourced from Overture Maps dataset
+- Buildings with NaN values (outside CONUS) are excluded
+- Building locations sourced from Overture Maps dataset
 
 ### File Location
 
@@ -223,9 +223,9 @@ The consolidated building dataset is available at:
 
 This single-file format enables:
 
--   Efficient CONUS-wide spatial queries
--   Direct access for analysis tools and workflows
--   Simplified data distribution and versioning
+- Efficient CONUS-wide spatial queries
+- Direct access for analysis tools and workflows
+- Simplified data distribution and versioning
 
 ## Data Validation
 
@@ -249,28 +249,28 @@ This single-file format enables:
 
 All datasets include descriptive metadata attributes:
 
--   `description`: Human-readable description of the variable
--   `long_name`: Extended variable name
--   `units`: Physical units (if applicable)
--   `composition`: Method used for compositing (e.g., "weighted")
--   `direction_labels`: Cardinal/ordinal direction labels for wind data
--   `weights_source`: Source of weights used in calculations
+- `description`: Human-readable description of the variable
+- `long_name`: Extended variable name
+- `units`: Physical units (if applicable)
+- `composition`: Method used for compositing (e.g., "weighted")
+- `direction_labels`: Cardinal/ordinal direction labels for wind data
+- `weights_source`: Source of weights used in calculations
 
 ## Access Patterns
 
 ### Raster Data
 
--   **By Region**: Query specific regional chunks using latitude/longitude slices
--   **Full CONUS**: Access complete dataset via Icechunk storage
+- **By Region**: Query specific regional chunks using latitude/longitude slices
+- **Full CONUS**: Access complete dataset via Icechunk storage
 
 ### Vector Data
 
--   **Full Dataset**: Query the consolidated CONUS-wide building dataset
--   **Spatial Query**: Use bounding box attributes for efficient spatial filtering
--   **Attribute Query**: Filter by risk threshold using Parquet predicate pushdown with DuckDB or similar tools
--   **Regional Subset**: Extract specific areas using spatial predicates on latitude/longitude
+- **Full Dataset**: Query the consolidated CONUS-wide building dataset
+- **Spatial Query**: Use bounding box attributes for efficient spatial filtering
+- **Attribute Query**: Filter by risk threshold using Parquet predicate pushdown with DuckDB or similar tools
+- **Regional Subset**: Extract specific areas using spatial predicates on latitude/longitude
 
 ## Related Documentation
 
--   [Data Downloads](../access-data.md): Information on accessing and downloading datasets
--   [Deployment](deployment.md): Details on data storage infrastructure
+- [Data Downloads](../access-data.md): Information on accessing and downloading datasets
+- [Deployment](deployment.md): Details on data storage infrastructure

docs/terms-of-data-access.md

@@ -1,6 +1,6 @@
 ## License Agreement
 
-Open Climate Risk data are made available under the licenses listed on the [Access Data](access-data.md#download-options) page. By accessing the data, you agree to adhere to the license terms.
+Open Climate Risk data are made available under the licenses listed on the [Access Data](access-data.md) page. By accessing the data, you agree to adhere to the license terms.
 
 ## Our Terms of Use Apply To Open Climate Risk