Explanation

Conceptual writing about why Lore works the way it does.

What this folder is

Explanation is the why of Lore. These pages make connections, give context, and dig into the choices and history behind the design. They're about understanding, not about getting a task done.

What you'll find here

• System design — the rationale, goals, and full architecture of Lore in one document: why Lore exists and the problems it solves, the revision graph and content-addressed storage, and the on-disk formats and protocols.

Suggested starting points

• Writing a new Explanation page? Start at the doc-standards walkthrough.
• Explanation template. Copy this when starting a new Explanation.

See docs/README.md for the full docs structure.