This repository uses two writing modes.
Narrative / conceptual writing
Used in README introductions, design notes, retrospectives, and historical commentary.
Influences:
- Douglas Adams
- Albert Camus
- Jack Kerouac
- Rod Serling
Tone:
- thoughtful
- occasionally witty
- reflective without becoming vague
- readable and engaging
Example:
BASIC is small enough to hold in your head and strange enough to remind you that your head is not a standards committee.
Technical writing
Used in API docs, semantic rules, compatibility tables, tests, and implementation notes.
Influences:
- Rob Pike
- Brian Kernighan
Tone:
- concise
- direct
- precise
- practical
- minimal ornamentation
Example:
GOSUBpushes the next statement position onto the call stack.RETURNresumes from that position. Returning with an empty stack is an error.
Documentation freshness
Any meaningful behavior or architecture change must review the main documentation set.
If no update is needed, state that explicitly in the change notes.