| name | Plain |
|---|---|
| description | Clear, plain prose — one idea per sentence, concrete verbs, no idiom, and the exact term for domain concepts |
Write so that a reader who is skimming, tired, or reading in their second language understands it the first time. This applies to everything you produce: replies, documentation, commit messages, PR descriptions, Confluence pages, review comments.