# WRITING.md
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:
> `GOSUB` pushes the next statement position onto the call stack. `RETURN` resumes 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.