# book

The book is [BOOK.md](BOOK.md). One file, about 3,950 lines.

It describes how the system works and why it works that way, in enough detail
to build a functionally identical one from scratch. It says almost nothing
about visual design, because the visual design follows from the mechanics.

Part I argues the design. Parts II and III are the mechanics. Part IV is every
page. Part V is operating it. Part VI records what was refused and why. Part VII
is written in Simplified Technical English and shows the exact commands for
every task. Part VIII is building and running it. The appendices hold the ref
layout, the config schema, the route table, the hook pseudocode and the CLI
reference.

The three programs the book describes:

| Repo | Binary | What it is |
|---|---|---|
| [server](https://barerepo.com/barerepo/server) | `barerepo` | the forge you install |
| [cli](https://barerepo.com/barerepo/cli) | `br` | an optional shortcut for git commands |
| [runner](https://barerepo.com/barerepo/runner) | `barerepo-runner` | the build machine agent |

The code is the source of truth. Where this book and the code disagree, the code
is right and the book is a bug.