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.