Writing Clearly — простой и понятный текст

Core principle

Care for the reader. A text works when the reader understands it on first pass and gets something useful from it. Two rules, in this order:

1. Ясно — the reader must understand. Clarity comes first.
2. Коротко — every word must earn its place. Brevity serves clarity, never replaces it.

Cutting words is not the goal. «Коротко — не значит ясно»: throw out the trash, but ADD tools of clarity — examples, concrete details, structure. A long clear text beats a short murky one.

When to use

Any prose a human will read: docs, README, PR descriptions, reports, letters, posts, release notes, error messages, UI text, explanations, chat answers — Russian or English.