# 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.
