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
31 lines
4.3 KiB
HTML
31 lines
4.3 KiB
HTML
<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
<title>Design notes — 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" class="here">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>
|
|
<p class="src">Source: <a href="https://github.com/fiddlerwoaroof/improvise/blob/main/docs/design-notes.md">docs/design-notes.md</a></p><details class="toc" open><summary>On this page</summary><ul><li class="l1"><a href="#design-notes">Design Notes</a></li><li class="l2"><a href="#product-vision">Product Vision</a></li><li class="l2"><a href="#non-goals-v1">Non-Goals (v1)</a></li></ul></details><h1 id="design-notes">Design Notes</h1>
|
|
<blockquote><p><strong>Staleness warning:</strong> This document captures conceptual framing from the original specification. It is not kept in sync with the code. For current architecture and types, see <a href="repo-map.html"><code>context/repo-map.md</code></a> and <a href="design-principles.html"><code>context/design-principles.md</code></a>.</p></blockquote>
|
|
<h2 id="product-vision"><a class="anchor" href="#product-vision">#</a>Product Vision</h2>
|
|
<p>Traditional spreadsheets conflate data, formulas, and presentation into a single flat grid addressed by opaque cell references (A1, B7). This makes models fragile, hard to audit, and impossible to rearrange without rewriting formulas.</p>
|
|
<p>Improvise treats data as a multi-dimensional, semantically labeled structure -- separating data, computation, and views into independent layers. Formulas reference meaningful names, views can be rearranged instantly, and the same dataset can be explored from multiple perspectives simultaneously.</p>
|
|
<p>The application compiles to a single static binary and provides a rich TUI experience.</p>
|
|
<h2 id="non-goals-v1"><a class="anchor" href="#non-goals-v1">#</a>Non-Goals (v1)</h2>
|
|
<ul>
|
|
<li>Scripting/macro language beyond the formula system.</li>
|
|
<li>Collaborative/multi-user editing.</li>
|
|
<li>Live external data sources (databases, APIs).</li>
|
|
<li>Charts or graphical visualization.</li>
|
|
<li>Multi-level undo history.</li>
|
|
</ul>
|
|
</main>
|
|
</div>
|
|
</body>
|
|
</html>
|