?? Active and passive voice—both have their place in documentation. The trick is knowing when to use each. Learn more in the blog below ??
Active vs. Passive voice in software documentation: When to use each? Clarity matters! Documentation should help users get things done, not slow them down. One of the biggest factors? Using the right voice. ? Why active voice? Active voice makes instructions clearer, more direct, and easier to follow. Instead of saying: X “The Submit button should be clicked to proceed.” ? “Click the Submit button to proceed.” ?? Google, Microsoft, and Stripe all recommend active voice because it improves comprehension, reduces ambiguity, and makes documentation more engaging. ?? When passive voice is useful? While active voice is preferred, passive voice has its place. It works well when: — Avoiding blame (“An error was encountered”) — The actor is unknown or irrelevant (“The database was updated”) — Emphasizing the action over the performer (“The file is saved automatically”) Want to learn how to optimize your documentation with the right balance of active and passive voice? Check out the full blog, and learn about how to leverage AI-powered tools to improve your docs. (?? Link in comments ?) #startup #AI #software