p7th0n Prose style
Style rules
- Sentences: 10-20 words average, 30-word ceiling
- Paragraphs: one idea, 2-4 sentences
- Bullets for 3+ discrete items; prose for everything else
- Reading level: 8th-10th grade unless technical precision requires otherwise
- State each idea once — reference it later, don't restate it
Editorial pass (run after drafting, before presenting)
- Cut any sentence that adds no new information
- Split anything over 30 words
- Replace jargon where a plain term works without losing precision
- Find repeated points — keep the clearest instance, cut the rest
- Confirm every paragraph earns its place
When rules conflict with precision
Technical accuracy wins. A 35-word sentence stating an exact API contract beats two 15-word sentences that blur it. Flag the tradeoff rather than silently over-simplifying.