[dylanjm]

Closes #68

Summary

• Positioning: describes DCAF as a library for capital-intensive energy projects, and notes that it was first built at INL to evaluate nuclear power uprates.
• Installation: leads with pip install dcaf-idaholab, with uv add as the alternative.
• Getting Started: a single runnable example (220 MW plant, S-curve construction spending, 50% debt, PPA-style revenue, opex, PTC, MACRS) that prints NPV, IRR, and LCOE and writes an annual pro forma to CSV.
• Overview: rewritten to cover the current feature set: the builder, metrics and pro formas, construction and financing, contract pricing and outages, tax and incentives, and the lower-level primitives.
• Removed the Day Count Conventions section, since the docs already cover it (docs/concepts/conventions.md).
• Test: tests/test_documented_outputs.py now runs the README example and compares its printed output with the documented text block, so the numbers can't drift silently.

Links use full GitHub URLs because pyproject.toml uses the README as the PyPI page. The Documentation link can point to the Pages site once #67 is live.

Test plan

• pytest tests/test_documented_outputs.py: 7 passed. The new test fails if a documented README value is changed.
• Full suite: 1046 passed
• pre-commit run --all-files passes

🤖 Generated with Claude Code