Skip to content

docs: state the facts without arguing for them - #29

Merged
kannandreams merged 1 commit into
mainfrom
docs/plainer-prose
Sep 10, 2026
Merged

docs: state the facts without arguing for them#29
kannandreams merged 1 commit into
mainfrom
docs/plainer-prose

Conversation

@kannandreams

Copy link
Copy Markdown
Owner

Summary

The Security page had picked up a defensive register — sentences spending words insisting on a point the surrounding fact already made:

Was Now
"That figure is not typed into the page." (cut; the mechanism sentence that followed already says it)
"a consequence of its design, not a policy bolted on afterward … never needs more trust than any other unprivileged process" "agent-top is read-only and local-only. It reads the transcripts a harness already wrote and the process table the OS already keeps, and changes neither."
"The network, enumerated exactly" / "Two calls, both narrow enough to name in full" "Network calls" / "There are two."
"It has nothing to leak on that front because it was never given anything to hold." (cut)
"the source is the whole story" (cut)
"The daily schedule is the one that matters most." "The daily run catches what a push cannot: …"

Same tic removed from the tracing post: "A debugging session, not a demo" → "Debugging a slow turn", plus two asides that announced their own honesty ("worth being honest about", "That's the actual point"). README security section loses "part of the security story" and gains the schedule instead.

No facts changed or dropped.

Test plan

  • mise run docs:build (strict) passes.

The Security page had picked up a defensive register: a figure introduced
by saying it was "not typed into the page", a model described as "not a
policy bolted on afterward", network calls "enumerated exactly", a
dependency with "nothing to leak because it was never given anything to
hold". Each sentence spent words insisting on a point the surrounding
fact already makes.

Same tic removed from the tracing post: a section headed "A debugging
session, not a demo" is now "Debugging a slow turn", and two asides that
announced their own honesty now just say the thing.
@kannandreams
kannandreams merged commit f256172 into main Sep 10, 2026
@kannandreams
kannandreams deleted the docs/plainer-prose branch September 10, 2026 20:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant