writing-best-practices

To remove AI-like phrasing from documentation, rewrite drafts to be clear and direct by eliminating filler, prioritizing punchlines, and using concrete nouns. This preserves your preferred voice while ensuring professional prose sounds human.

The best way to improve readability for blog posts is to keep paragraphs tight, minimize signposting, and avoid generic conclusions. Prefer concrete nouns, numbers, and dates over vague descriptions to make the writing direct and human-sounding.

Yes, you can use this editing workflow for UI copy and emails where preserving the author's voice matters. It applies a frontmatter-driven process to guide edits, enforce preferred voice, and provide practical examples for clear, direct prose.

To enforce a specific writing style for technical issues, the workflow reads a preferred-voice reference file to guide edits. It removes AI-sounding phrasing and vagueness, ensuring your issues maintain a consistent, candid, and specific style.