Skip to content

Lay out the repository, and give a fresh clone two commands that work #13

Description

@iderex

Somebody who clones this repository today can build nothing and run nothing.
Before any of that can be true there has to be a layout, and the layout is worth
one decision rather than eleven accidents.

The test of a good answer is short. A person who has never seen the repository
runs two commands from README.md and both succeed on a clean machine with only
the pinned toolchain installed.

What this issue produces

A directory layout with one directory per concern from the boundary record in #3,
so that the boundary is visible in the tree rather than only in a document.

One command that builds everything and one that runs every test, both named in
README.md and both used verbatim by the gate, so the gate and a contributor run
the same thing.

A note in README.md saying what a fresh clone needs installed and nothing more.

Done when

README.md names the two commands. Both succeed from a clone with no state left
by a previous build. The gate workflows added in this milestone invoke those same
two commands rather than their own variants. Blocked on #11.

Metadata

Metadata

Assignees

Labels

architectureShape of the core: boundaries, interfaces, contractsdocumentationImprovements or additions to documentation

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions