Engineering the Earth (EarthBlueprint)

Repository skeleton for a structured database of world problems and solutions.

Structure: alpha-sorted continents → countries → cities. Use /templates for contributor templates and update registry.json when adding cities.

---

Documentation site (docs/)

A small static site lives under docs/ for browsing the repository content in a web UI. To generate the data used by the site:

1. Install dependencies: pip install pyyaml
2. Run: python3 scripts/build_docs.py (from the repository root) — this generates docs/data/registry.json and per-city JSON in docs/data/cities/.
3. Serve the site: python3 -m http.server -d docs 8000 and open http://localhost:8000.

This directory is GitHub Pages friendly (set Pages source to docs/).

CI: A GitHub Actions workflow (.github/workflows/build-and-deploy-docs.yml) validates YAML with yamllint, validates problem/solution files against framework/schemas/*, builds the docs/data/ JSON, and deploys docs/ to GitHub Pages on pushes to main.