docs: add grammar examples for 'the' and 'to be' rules

This commit is contained in:
russell@unturf.com 2026-03-20 08:04:24 -04:00
parent b303f497fa
commit 63ad455374

View file

@ -150,11 +150,13 @@ Git operations can be destructive to uncommitted work. Always preserve user's wo
**Grammar: Avoid "the" in posts**
- Never use "the" when "a" works instead
- Prefer dropping articles entirely when a sentence reads clean without one
- Example: "a permacomputer" not "the permacomputer"
- Example: "angle brackets. closing tags. verbosity." not "the angle brackets. the closing tags. the verbosity."
- Restructure sentences to eliminate "the" rather than forcing awkward substitutions
**Grammar: Avoid verbs "to be" (is, are, was, were, be, been, being)**
- Prefer active verbs over passive or linking constructions
- Example: "a permacomputer outlasts its builders" not "a permacomputer is something that outlasts its builders"
- Example: "Jason lives everywhere" not "Jason is everywhere"
- Example: "TOML fits like a studio apartment" not "TOML is a studio apartment"
- Contractions count: "it's" = "it is", "he's" = "he is", "that's" = "that is"