# TipSharks Documentation Index

## Core
- [Architecture](architecture.md)
- [Data Model](data_model.md)
- [Rating Math](rating_math.md)
- [Rating Algorithm](ALGORITHM.md)
- [Elo Tuning Guide](elo_tuning.md)
- [Operations](ops.md)
- [Troubleshooting](troubleshooting.md)

## HRNZ Scraper
- [Scraper Guide](hrnz/HRNZ_SCRAPER_GUIDE.md)
- [Scraper Implementation](hrnz/HRNZ_SCRAPER_IMPLEMENTATION.md)
- [API Alignment Issues](hrnz/HRNZ_API_ALIGNMENT_ISSUES.md)
- [API Fixes Summary](hrnz/HRNZ_API_FIXES_SUMMARY.md)

## Setup and Migration
- [Setup Guide](setup/SETUP_GUIDE.md)
- [Monorepo Notes](setup/MONOREPO.md)
- [Migration Fix Summary](migrations/MIGRATION_FIX_SUMMARY.md)

## Status and Analysis
- [Project Status](status/PROJECT_STATUS.md)
- [Rebuild Status](status/REBUILD_STATUS.md)
- [Historical Data Analysis](status/HISTORICAL_DATA_ANALYSIS.md)
- [Reconciliation Plan](status/RECONCILIATION_IMPLEMENTATION_PLAN.md)

## Samples
- [Sample URLs](samples/hrnz_sample_urls.txt)
- [Sample Rendered HTML](samples/hrnz_sample_rendered.html)
- [January 2026 URLs](samples/january_2026_urls.txt)

## Build the Docs Site

The static docs site is built with MkDocs and served by the API at `/docs/site/`.

```bash
venv/bin/mkdocs build -f mkdocs.yml
```