10 tips for Software Development managers about user documentation

Posted by alanandrew on Monday, May 9, 2016 under Technical Writing | Comments are de-activated

Software User Documentation is often a last minute effort to deliver your software product and get it out the door. Your development team had a long list of requirements, so the documentation sometimes gets downsized in importance or it is sometimes neglected completely.

Read more …. »

How out-of-date documentation can cost you

Posted by alanandrew on under Technical Writing, Third-Party Articles | Comments are de-activated

As usual, I bring this article to you courtesy of JACQUIE SAMUELS, as I think it adds relevance to what I am setting out to achieve with my documentation framework. You may view the original article here.

Documentation is (sadly but understandably) often the last push in the great effort to get a product out the door and into the hands of your customers. Because it’s the last thing on a long list of release requirements, it sometimes gets downsized in effort or time or neglected completely. At the heart of the matter, companies feel like shirking on their documentation deliverables is a possible solution to time and budget crunches. They feel this way because they consider documentation as an add-on to the product, an extra bit of service provided to customers but not an essential component of the product itself.

 

Guess what: That’s not how customers see it.

Read more …. »

16 Reasons Why Your Users Do Not Read User Documentation

Posted by alanandrew on Sunday, May 8, 2016 under Research, Technical Writing, Third-Party Articles | Comments are de-activated

I bring this article to you courtesy of Dennis Crane, as I think it adds relevance to what I am setting out to achieve with my documentation framework. You may view the original article here.

 

Nobody reads help files!

Are you sure?

In the ten years that we’ve been developing Dr.Explain, a leading-edge tool for creating help files, we saw hundreds of our customers’ projects. Our technical support team mostly receives user documentation for software products with requests to help implement some tricks. When talking with our customers, we ask them all kinds of questions about their projects, business areas, products, and audiences.
Based on that experience, we can draw a lot of conclusions, including this one: Users do read user documentation. In many cases, users frequently consult with such documentation. In some projects, it is a vital component of the product or services.

However, sometimes people do not use user documentation. In most cases, the reasons are as follows.

Read more …. »