From b6450d866d51736420a01ae4691f9fa76ce1e74f Mon Sep 17 00:00:00 2001 From: Nexoniarz Date: Sat, 12 Sep 2026 21:58:20 +0200 Subject: [PATCH] docs: a footer note on building with AI The point is not a disclaimer, it is the argument: the tool is not the measure of a project. Code nobody understands is bad code whoever typed it, and code whose every decision can be explained is good code by the same standard. Placed next to a link to history/ on purpose. That directory is where the claim can be checked -- the bugs are written up in full, including the wrong hypotheses and the measurements that killed them. An explanation you can follow is the evidence; a byline is not. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01VQ7Qx8E1q1M1bbCq8QLHS2 --- docs/Website/README.md | 13 +++++++++++++ docs/Website/docs.html | 10 ++++++++++ docs/Website/index.html | 10 ++++++++++ docs/Website/style.css | 15 +++++++++++++++ 4 files changed, 48 insertions(+) diff --git a/docs/Website/README.md b/docs/Website/README.md index c67ad36..d0a850c 100644 --- a/docs/Website/README.md +++ b/docs/Website/README.md @@ -41,6 +41,19 @@ python3 -m http.server 8000 Adding a document means adding one line to the `DOCS` array in `docs.js`. The reader will only load a path that appears there. +## The two footer notes + +Both pages carry two statements below the licence line, and both are meant to +be read rather than skimmed past. + +The first is the flag, below. The second is about AI, and it says the thing +worth saying: the tool is not the measure. A project is good when the people +building it understand what was built. That claim is deliberately made next to +a link to `history/`, because that directory is where it can be checked — the +bugs are written up in full, including the wrong turns and the measurements +that disproved them. An explanation you can follow is the evidence; the byline +is not. + ## The flag `Assets/pride.svg` is in the top bar and in the footer, on both pages, and it diff --git a/docs/Website/docs.html b/docs/Website/docs.html index 77a0481..676be54 100644 --- a/docs/Website/docs.html +++ b/docs/Website/docs.html @@ -55,6 +55,16 @@ Built by, and for, people of every orientation and gender identity. The flag stays up all year. + + On AI. + Parts of SchOS were written with AI assistance, and that is not the measure + of anything. A project is good when the people building it understand what + was built, and bad when nobody does — whoever, or whatever, typed it. Vibe + your way through and you get something no one can fix. Stay in the loop and + you get a system you can explain line by line. The bug writeups in + history/ are where that gets + checked, including the wrong turns. + diff --git a/docs/Website/index.html b/docs/Website/index.html index 0239fe0..b47d8aa 100644 --- a/docs/Website/index.html +++ b/docs/Website/index.html @@ -295,6 +295,16 @@ Built by, and for, people of every orientation and gender identity. The flag stays up all year. + + On AI. + Parts of SchOS were written with AI assistance, and that is not the measure + of anything. A project is good when the people building it understand what + was built, and bad when nobody does — whoever, or whatever, typed it. Vibe + your way through and you get something no one can fix. Stay in the loop and + you get a system you can explain line by line. The bug writeups in + history/ are where that gets + checked, including the wrong turns. + diff --git a/docs/Website/style.css b/docs/Website/style.css index 26f96f4..b05b4a0 100644 --- a/docs/Website/style.css +++ b/docs/Website/style.css @@ -576,3 +576,18 @@ body.reading footer { margin-top: auto; } .top nav a.on { color: var(--fg); } .readerlink { margin-top: 2rem; } + +/* A footer note that is a paragraph rather than a credit line. Same width + discipline as body text: these are read, not scanned. */ +footer .note { + flex-basis: 100%; + max-width: 54rem; + color: var(--dim); + font-size: 0.82rem; + line-height: 1.7; +} +footer .note b { color: var(--fg); font-weight: 700; } +footer .note a { color: var(--accent); } + +/* The two notes sit below the identity line, not beside it. */ +footer .wrap { row-gap: 1.5rem; }