Edward Langley
787e354b9b
The `build` job fails on main and on every branch merged from it: doc-site: context/code/pr-review.md is neither published nor a named omission NOT a merge loss -- scripts/build-doc-site.mjs in this branch is byte-identical to main's, and neither lists the file. PR #96 added context/code/pr-review.md without a manifest line, which is exactly the gate improvise-res9 added: a doc added without a line publishes nothing and says nothing, so the generator refuses. Omitted rather than published, and the line is cloud-agents.md's rather than tooling.md's. tooling.md explains checkers a reader of the code will meet; pr-review.md is about THIS REPOSITORY'S PROCESS -- where a Codex review appears, how to tell it from our own agents' comments, why absence is not approval. Nobody visiting a website is about to read a PR thread. Both homes updated, because an omission is restated beside the manifest AND in doc-site.md section 2, and the prose there counted them ("Neither is referenced...") so it went stale at three. This strays into scripts/, which is Wave N's ground. Flagged in the hand-back; it is a one-line data entry either way if the orchestrator would rather publish it. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01FC2jVn8Au7E9JPkw6bwXXH
23 lines
6.2 KiB
HTML
23 lines
6.2 KiB
HTML
<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
<title>Documentation — improvise docs</title>
|
|
<link rel="stylesheet" href="style.css" />
|
|
</head>
|
|
<body>
|
|
<div class="shell">
|
|
<nav class="side"><a class="brand" href="index.html">improvise docs</a><input type="checkbox" id="navtoggle" class="navtoggle" /><label class="navsummary" for="navtoggle">Pages</label><div class="navlinks"><ul><li><a href="../index.html">← Project home</a></li><li><a href="../app/">Browser demo</a></li><li><a href="https://github.com/fiddlerwoaroof/improvise">Source on GitHub</a></li></ul><h3>Start here</h3><ul><li><a href="design-notes.html">Design notes</a></li><li><a href="design-principles.html">Design principles</a></li><li><a href="repo-map.html">Repository map</a></li></ul><h3>Decision records</h3><ul><li><a href="adr/001-concurrent-edits.html">ADR 001 — Concurrent edits</a></li><li><a href="adr/002-naming-a-cell.html">ADR 002 — Naming a cell</a></li><li><a href="adr/003-live-backed-models.html">ADR 003 — Live-backed models</a></li></ul><h3>The arguments, by area</h3><ul><li><a href="code/core.html">improvise-core</a></li><li><a href="code/formula-and-io.html">improvise-formula and improvise-io</a></li><li><a href="code/protocol.html">improvise-protocol</a></li><li><a href="code/command.html">improvise-command</a></li><li><a href="code/clients.html">The clients</a></li><li><a href="code/tui.html">The TUI</a></li><li><a href="code/gp.html">gp-tree and improvise-gp</a></li><li><a href="code/kb-tool.html">The kb tool</a></li><li><a href="code/tooling.html">The repository's own checkers</a></li></ul><h3>Test evidence</h3><ul><li><a href="test-evidence/core.html">improvise-core</a></li><li><a href="test-evidence/formula-and-io.html">improvise-formula and improvise-io</a></li><li><a href="test-evidence/protocol.html">improvise-protocol</a></li><li><a href="test-evidence/command.html">improvise-command</a></li><li><a href="test-evidence/clients.html">The clients</a></li><li><a href="test-evidence/tui.html">The TUI</a></li><li><a href="test-evidence/gp.html">gp-tree and improvise-gp</a></li><li><a href="test-evidence/tooling.html">The repository's own gates</a></li></ul><h3>About this site</h3><ul><li><a href="doc-site.html">About this site</a></li></ul><h3>Reference</h3><ul><li><a href="tickets.html">Ticket index</a></li></ul></div></nav>
|
|
<main>
|
|
<h1>improvise — documentation</h1>
|
|
<p class="lede">These are the working documents of the improvise repository, published as written. They are addressed to someone reading or changing the code: the arguments behind the architecture, the decisions that were made and the ones that were rejected, and the record of what each load-bearing test is guarding against.</p>
|
|
<p class="lede">Nothing here is a tutorial. For what the program does, see the <a href="../index.html">project home</a> or run the <a href="../app/">browser demo</a>.</p>
|
|
<h2 id="start"><a class="anchor" href="#start">#</a>Start here</h2><p class="lede">What the project is for, and the principles the code is held to.</p><div class="cards"><div class="card"><a href="design-notes.html">Design notes</a></div><div class="card"><a href="design-principles.html">Design principles</a></div><div class="card"><a href="repo-map.html">Repository map</a></div></div><h2 id="adr"><a class="anchor" href="#adr">#</a>Decision records</h2><p class="lede">Decisions with consequences, including the options that were rejected.</p><div class="cards"><div class="card"><a href="adr/001-concurrent-edits.html">ADR 001 — Concurrent edits</a></div><div class="card"><a href="adr/002-naming-a-cell.html">ADR 002 — Naming a cell</a></div><div class="card"><a href="adr/003-live-backed-models.html">ADR 003 — Live-backed models</a></div></div><h2 id="code"><a class="anchor" href="#code">#</a>The arguments, by area</h2><p class="lede">The reasoning that used to live in code comments. Written for a reader with the source open.</p><div class="cards"><div class="card"><a href="code/core.html">improvise-core</a></div><div class="card"><a href="code/formula-and-io.html">improvise-formula and improvise-io</a></div><div class="card"><a href="code/protocol.html">improvise-protocol</a></div><div class="card"><a href="code/command.html">improvise-command</a></div><div class="card"><a href="code/clients.html">The clients</a></div><div class="card"><a href="code/tui.html">The TUI</a></div><div class="card"><a href="code/gp.html">gp-tree and improvise-gp</a></div><div class="card"><a href="code/kb-tool.html">The kb tool</a></div><div class="card"><a href="code/tooling.html">The repository's own checkers</a></div></div><h2 id="evidence"><a class="anchor" href="#evidence">#</a>Test evidence</h2><p class="lede">For each test whose narrative is longer than its code: what broke, what fault was injected, and why the test can fail. Contributor reference, not a tour.</p><div class="cards"><div class="card"><a href="test-evidence/core.html">improvise-core</a></div><div class="card"><a href="test-evidence/formula-and-io.html">improvise-formula and improvise-io</a></div><div class="card"><a href="test-evidence/protocol.html">improvise-protocol</a></div><div class="card"><a href="test-evidence/command.html">improvise-command</a></div><div class="card"><a href="test-evidence/clients.html">The clients</a></div><div class="card"><a href="test-evidence/tui.html">The TUI</a></div><div class="card"><a href="test-evidence/gp.html">gp-tree and improvise-gp</a></div><div class="card"><a href="test-evidence/tooling.html">The repository's own gates</a></div></div><h2 id="meta"><a class="anchor" href="#meta">#</a>About this site</h2><p class="lede">What is published here, what is not, and why.</p><div class="cards"><div class="card"><a href="doc-site.html">About this site</a></div></div>
|
|
<h2 id="conventions"><a class="anchor" href="#conventions">#</a>Conventions</h2>
|
|
<p>Ids like <code>improvise-9c8c</code> are tracker issues and link to the ticket index below. Paths like <a href="https://github.com/fiddlerwoaroof/improvise/blob/main/crates/improvise-core/src/model/types.rs"><code>crates/improvise-core/src/model/types.rs</code></a> link to the source on GitHub at <code>main</code>.</p>
|
|
</main>
|
|
</div>
|
|
</body>
|
|
</html>
|