writing-clearly-and-concisely

Clarity and conciseness improve readability by applying established style principles: use active voice, positive form, concrete language, omit needless words, and keep related words together. Apply these principles to documentation, README files, commit messages, error messages, UI text, and help content across software projects.

Identify and rephrase ambiguous or convoluted sentences using active voice, definite terms, and concrete examples. Reference style guides like elements-of-style.md when copyediting. Eliminate unnecessary words and phrases to tighten your writing without sacrificing meaning.

Yes. Before sending important emails to stakeholders or publishing reports, review your draft to ensure it is clear, to the point, and effectively conveys your message without jargon. The skill applies to any human-facing prose in software projects.

This skill applies to documentation, README files, commit messages, error messages, UI text, help content, reports, and explanations across software projects. It enhances any human-facing prose by enforcing functional requirements like active voice and conciseness.

Keeping related words together reduces cognitive load and improves comprehension. When modifiers, verbs, and objects are grouped logically, readers grasp your meaning faster. This principle, combined with active voice and concrete language, is a core foundation of clear technical communication.

Conciseness optimization removes redundancy and filler while preserving meaning. Focus on functional requirements: use definite, concrete language; avoid passive constructions; and eliminate words that don't add clarity. This approach tightens prose while keeping essential information intact.