Docs copy cleanup pass (#369)

* Update landing page

* Data access updates

* Make key copy edits

* More consistent cross-page references

* More consistent sentence-casing

* Capitalize terms page, consistent with OffsetsDB

* Fix broken admonition

* Update disclaimer text

Author: katamartin

docs/access-data.md

@@ -1,29 +1,29 @@
-# Open Climate Risk data pipeline
+# Data pipeline
 
 The Open Climate Risk (OCR) data pipeline processes climate risk data through a series of coordinated stages, from individual region processing to final tile generation for visualization.
 
 ## Overview
 
 The pipeline transforms raw climate data into risk assessments through four main stages:
 
-1. **Region Processing** - Calculate risk metrics for individual geographic regions
-2. **Data Aggregation** - Combine regional results into consolidated datasets
-3. **Statistical Summaries** - Generate county and tract-level statistics (optional)
-4. **Tile Generation** - Create PMTiles for web visualization
+1. **Region processing** - Calculate risk metrics for individual geographic regions
+2. **Data aggregation** - Combine regional results into consolidated datasets
+3. **Statistical summaries** - Generate county and tract-level statistics (optional)
+4. **Tile generation** - Create PMTiles for web visualization
 
-## Getting Started
+## Getting started
 
 ### Prerequisites
 
-- Python environment with OCR package installed (see [installation guide](../how-to/installation.md))
+- Python environment with OCR package installed (see [Installation guide](../how-to/installation.md))
 - AWS credentials (for data access)
 - Coiled account (for cloud execution, optional)
 
 ### Tutorial: quick end-to-end (local)
 
 This tutorial walks you through a short, practical run that processes one region locally and inspects the output.
 
-1. Ensure your environment is configured and the package is installed (see [installation guide](../how-to/installation.md)).
+1. Ensure your environment is configured and the package is installed (see [Installation guide](../how-to/installation.md)).
 1. Copy an example env and set a local storage path for quick testing:
 
 ```bash
@@ -58,7 +58,7 @@ ocr run --region-id y10_x2 --region-id y11_x3 --platform coiled --env-file .env
 
 1. Monitor the job on Coiled's web UI and check outputs in your `OCR_STORAGE_ROOT` bucket.
 
-### Basic Usage
+### Basic usage
 
 Process a single region locally:
 
@@ -78,9 +78,9 @@ Process all available regions:
 ocr run --all-region-ids --platform coiled
 ```
 
-## Execution Platforms
+## Execution platforms
 
-### Local Platform
+### Local platform
 
 **Best for:** Development, testing, debugging, small datasets
 
@@ -90,7 +90,7 @@ ocr run --all-region-ids --platform coiled
 - Limited by local computational resources
 - Sequential processing only
 
-### Coiled Platform
+### Coiled platform
 
 **Best for:** Production workloads, large-scale processing, parallel execution
 
@@ -102,7 +102,7 @@ ocr run --all-region-ids --platform coiled
 
 ## Configuration
 
-### Environment Setup
+### Environment setup
 
 Create a `.env` file for your configuration:
 
@@ -120,16 +120,16 @@ Use your configuration file:
 ocr run --env-file .env --region-id y10_x2
 ```
 
-### Key Configuration Components
+### Key configuration components
 
-- **Icechunk Store** - Version-controlled data storage backend
-- **Vector Output** - Location for processed geoparquet and PMTiles files
+- **Icechunk store** - Version-controlled data storage backend
+- **Vector output** - Location for processed geoparquet and PMTiles files
 - **Environment** - Data version/environment (prod, QA, etc.)
 - **Chunking** - Defines valid region boundaries and IDs
 
-## CLI Commands
+## CLI commands
 
-For detailed CLI documentation, see the [API Reference](../reference/api.md#cli-application).
+For detailed CLI documentation, see the [API reference](../reference/api.md#cli-application).
 
 ```bash
 # View all available commands
@@ -140,13 +140,13 @@ ocr run --help
 ocr aggregate-regional-stats --help
 ```
 
-### Pipeline Orchestration
+### Pipeline orchestration
 
-#### `ocr run` - Full Pipeline
+#### `ocr run` - full pipeline
 
 The main command that orchestrates the complete processing pipeline.
 
-**Key Options:**
+**Key options:**
 
 - `--region-id` - Process specific regions (can specify multiple)
 - `--all-region-ids` - Process all available regions
@@ -168,9 +168,9 @@ ocr run --region-id y10_x2 --region-id y11_x3 --risk-type wind --platform coiled
 
 ```
 
-### Individual Stage Commands
+### Individual stage commands
 
-#### `ocr process-region` - Single Region Processing
+#### `ocr process-region` - single region processing
 
 Process risk calculations for one specific region.
 
@@ -182,23 +182,23 @@ ocr process-region y10_x2 --risk-type fire
 ocr process-region y15_x7 --env-file production.env --risk-type wind
 ```
 
-#### `ocr partition-buildings` - Data Consolidation
+#### `ocr partition-buildings` - data consolidation
 
 Partition processed geoparquet files by state and county FIPS codes.
 
 ```bash
 ocr partition-buildings --env-file .env
 ```
 
-#### `ocr aggregate-region-risk-summary-stats` - Statistical Summaries
+#### `ocr aggregate-region-risk-summary-stats` - statistical summaries
 
 Generate county and tract-level risk statistics.
 
 ```bash
 ocr aggregate-region-risk-summary-stats --env-file .env
 ```
 
-#### `ocr create-regional-pmtiles` - Regional Tiles
+#### `ocr create-regional-pmtiles` - regional tiles
 
 Create PMTiles for county and tract-level visualizations.
 
@@ -214,7 +214,7 @@ Generate PMTiles from the consolidated building dataset.
 ocr create-building-pmtiles --env-file .env
 ```
 
-#### `ocr write-aggregated-region-analysis-files` - Write Analysis Files
+#### `ocr write-aggregated-region-analysis-files` - write analysis files
 
 Write aggregated region analysis files (csv, geoparquet and geojson).
 You can add the flag `--write-region-files` to `ocr run` to add this optional step in the pipeline.
@@ -225,7 +225,7 @@ ocr write-aggregated-region-analysis-files --env-file .env
 
 ## Troubleshooting
 
-### Common Issues
+### Common issues
 
 ### Environment configuration issues
 
@@ -241,13 +241,13 @@ Error: Missing required environment variables
 
 ### Resource and access issues
 
-#### Local Platform
+#### Local platform
 
 - **Disk space:** Check available space in temp directory
 - **Memory:** Reduce dataset size or increase system RAM
 - **Permissions:** Verify file/directory access rights
 
-#### Coiled Platform
+#### Coiled platform
 
 - **Job failures:** Check Coiled credentials and account quotas
 - **AWS access:** Verify IAM permissions and credentials

docs/how-to/data-pipeline.md

@@ -11,21 +11,21 @@ This guide helps you get started with accessing and using Open Climate Risk fire
 - **Multiple output formats**: Interactive web maps, downloadable datasets, and cloud-native data access
 - **Present and future scenarios**: Current conditions (circa 2011) and future projections (circa 2047)
 
-## Quick Access Options
+## Quick access options
 
-### Option 1: Explore the Web Tool
+### Option 1: explore the web tool
 
 The fastest way to explore Open Climate Risk data is through our [interactive web map](https://carbonplan.org/research/climate-risk). The web tool allows you to:
 
 - Search for specific addresses or locations
 - View building-level risk scores on a 0-10 scale
 - Explore state, county, census tract, and census block aggregations
 
-### Option 2: Access Production Data
+### Option 2: access production data
 
 If you want to analyze Open Climate Risk data programmatically, you can access our production datasets directly from cloud storage using Python.
 
-## Accessing Production Data
+## Accessing production data
 
 Open Climate Risk output data is stored in [Icechunk](https://icechunk.io/), a versioned, cloud-native data format that works seamlessly with `Xarray` and `Zarr`.
 
@@ -37,7 +37,7 @@ You'll need Python with a few packages installed:
 python -m pip install xarray icechunk
 ```
 
-### Load the Dataset
+### Load the dataset
 
 Here's a minimal example to load Open Climate Risk wind-adjusted fire risk data:
 
@@ -68,7 +68,7 @@ This gives you access to:
 - **Spatial coverage**: Full CONUS extent
 - **Multiple variables**: Burn probability, conditional risk, wind-adjusted metrics
 
-### Understanding the Data
+### Understanding the data
 
 The dataset contains several key variables:
 
@@ -77,41 +77,41 @@ The dataset contains several key variables:
 - **`crps`**: Conditional Risk to Potential Structures (damage if fire occurs)
 - Risk scores are for a "generic" or "potential" structure at each location
 
-:::{admonition} **Important Limitation**
+:::{admonition} **Important limitation**
 :class: note
 
 Risk scores represent a hypothetical structure and do NOT account for building-specific factors like construction materials, retrofits, or defensible space management.
 :::
 
-## Next Steps
+## Next steps
 
-### For Data Users
+### For data users
 
-- **[Working With Data](work-with-data.ipynb)**: Detailed guide on loading and analyzing Open Climate Risk datasets
-- **[Data Schema](../reference/data-schema.md)**: Complete reference of available variables and metadata
-- **[Access Data](../access-data.md)**: Direct download links and bulk access options
+- **[Working with data](work-with-data.ipynb)**: Detailed guide on loading and analyzing Open Climate Risk datasets
+- **[Data schema](../reference/data-schema.md)**: Complete reference of available variables and metadata
+- **[Access data](../access-data.md)**: Direct download links and bulk access options
 
-### For Researchers & Analysts
+### For researchers & analysts
 
-- **[Fire Risk Methods Overview](../methods/fire-risk/overview.md)**: Understand how risk scores are calculated
-- **[Data Sources](../reference/data-sources.md)**: Learn about data sources
+- **[Fire risk methods overview](../methods/fire-risk/overview.md)**: Understand how risk scores are calculated
+- **[Data sources](../reference/data-sources.md)**: Learn about data sources
 
-### For Developers
+### For developers
 
 - **[Installation](installation.md)**: Set up project for local development
-- **[Project Structure](../reference/project-structure.md)**: Understand the codebase
-- **[Data Pipeline](data-pipeline.md)**: Run the processing pipeline
-- **[Working With Input Datasets](work-with-input-datasets.md)**: View technical reference for working with input datasets
+- **[Project structure](../reference/project-structure.md)**: Understand the codebase
+- **[Data pipeline](data-pipeline.md)**: Run the processing pipeline
+- **[Working with input datasets](work-with-input-datasets.md)**: View technical reference for working with input datasets
 
 ## Support
 
 - **Issues & Bug Reports**: [GitHub Issues](https://github.com/carbonplan/ocr/issues)
 - **Questions & Discussions**: [GitHub Discussions](https://github.com/carbonplan/ocr/discussions)
 - **General Inquiries**: [hello@carbonplan.org](mailto:hello@carbonplan.org)
 
-## Available Data Versions
+## Available data versions
 
-Check our [GitHub Releases](https://github.com/carbonplan/ocr/releases) page for:
+Check our [GitHub releases](https://github.com/carbonplan/ocr/releases) page for:
 
 - Latest data version numbers
 - Release notes and changelogs
@@ -120,4 +120,4 @@ Check our [GitHub Releases](https://github.com/carbonplan/ocr/releases) page for
 
 ---
 
-_Ready to dive deeper? Check out the [Working With Data](work-with-data.ipynb) notebook for hands-on examples._
+_Ready to dive deeper? Check out the [Working with data](work-with-data.ipynb) notebook for hands-on examples._