Skip to content

docs: add the house writing style (#120) - #121

Merged
amar-python merged 1 commit into
mainfrom
docs/writing-style
Oct 27, 2026
Merged

amar-python merged 1 commit into
mainfrom
docs/writing-style

Conversation

@amar-python

Copy link
Copy Markdown
Owner

Fixes #120. Records the product owner's 27 Oct 2026 decision that a house writing style applies to all writing in this repo.

What changes

  • New docs/WRITING.md:
    • seven rules: evidence before status, closure evidence, stating gaps, product-owner decisions, runnable commands, traceable references, no secrets;
    • the conventions decided on 27 Oct;
    • issue and PR templates.
  • Docs only. No code changes.

Checks

  • No test changes.
  • git diff --stat against main: 1 file added.

The longer guide that this summarises is kept outside the repo: in the Project docs, and in .claude/, which is gitignored.


Generated by Claude Code

Records the product owner's 27 Oct 2026 decisions: the style applies
to all repo writing; Australian spelling in prose; no generated-by
footers on issues or PRs; "the product owner" on GitHub.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019YPoXzBSj89ZHgw7nfTmbB
@amar-python
amar-python merged commit d695d6f into main Oct 27, 2026
3 checks passed
@amar-python
amar-python deleted the docs/writing-style branch October 27, 2026 07:01
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.

docs: add the house writing style (docs/WRITING.md)

2 participants