Top 5 features of a great software user guide

Software user guides are good and useful, as long as they are well done.  What makes them great?


  1. No fluff.  Cut to to the chase.  Answer this question succinctly “how do I do this?  … or that?”.  Don’t fill a user guide with marketing jargen or unnecessary content.
  2. Relevant Examples.  Know your audience.   Provide real-world use case examples to describe precisely how to accomplish a given task.  When possible, these should come from actual customer support inquiries.
  3. Some pictures please.  A picture paints a thousand words.  Where appropriate, use some product screen shots for illustration and explantions.  Plain words and instruction are not always as effective.  Don’t be tempted to over-use screen shots though as you UI can change making this difficult to manage.
  4. Just the right amount of links for navigation.  Make it easy to navigate the guide, including listing relevant topics, a table of contents, glossary and index.  However, don’t over-use in content links as it can be distracting and disjointed to follow all links.  Your end-users can may be led astray, begin jumping around and not get the answer they were looking for in the first place!
  5. Keep it current.   Guides can quickly become “stale” as a software evolves through releases.  Ideally, review and update your guide with each software release.  Better still, publish new user guide release editions with each minor or major software product release to benefit those customers who have not yet upgraded.

Find it EZ is about to publish user guides for its full product line.  Software change made simple.

About the author

Ken Gnazdowsky holds a Bachelor of (Computing) Science degree from Simon Fraser University. A recipient of the Governor General of Canada bronze medallion, he began his post-secondary education at Brandon University on an academic scholarship, Ken has worked in the software development industry for over 30 years. Ken is co-founder and President of Find it EZ Software Corp., creators of the Microsoft award-winning products, Code Search Pro and Dev Surge 365.

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: