Is Poor Documentation Costing Your Company?

Is Poor Documentation Costing Your Company?

While most folks cringe at the very mention of the word "documentation", management realizes that it is a necessary evil in today's world. Even with this knowledge, documentation is still a major sticking point for most companies. Why is that? Is it because there is really no method to measure its effectiveness? Is it because it's hard to place a real value on something you know will sit on someone's bookshelf and collect dust? Keep these in mind as we go forward.

You would be hard-pressed to find someone that has purchased a product only to learn that the accompanying "manual/instructions" are completely worthless. We've all been there. But doesn't this company care that I can't use their product because of sub-par documentation? Don't they care that I will be inconvenienced by having to research the product "they" just sold me? That's the exact feeling I get and I'm convinced that folks reading this post feel the same way too! It's not a good feeling and it certainly goes a long way in my decision to buy from them again.

In the academic world, rubrics are a common form of defining expectations, providing a means for real-time feedback and measuring the quality of written papers. There is a place in the corporate world to implement something similar.

In its simplest form, technical documentation needs to answer the following questions. 

  • Who is the end-user (audience)?
  • What is the purpose of the documentation?

Identifying the audience and purpose is only the first step. We must then setup metrics to evaluate the effectiveness of the documentation being developed and presented. To successfully measure our work, the following questions must be answered.

  • Is the documentation visually appealing?
  • Is the documentation logically laid-out and organized?
  • Is the user able to quickly find answers to their issues?
  • Has the documentation had an impact on the overall safety of operating or maintaining the product?
  • Has the documentation had an impact on the product or service quality?
  • Has the documentation had an impact on the product or service orders?
  • Has the documentation had an impact on the amount of calls coming into your customer service department?

This is just the tip of the iceberg. There is so much more that needs to be considered when developing high quality documentation sets, and Hunter McKenzie L.P. knows what you need and what your customers expect! Our expertise in this arena affords us the ability to work how you think. 

From complex Equipment Manuals and Procedures to cutting-edge, Augmented Reality Training and Enhanced Media, let Hunter McKenzie L.P. turn your most complex, technical information into practical, usable documentation!

Jesse Spencer-Davenport

Asking questions and doing work that joins people, processes, and technology with revenue - because there's always room for more!

8 年

Mark, so true! Documentation is so critical but often overlooked and sub-par at best. I'm constantly amazed at the quality of documentation in leading software applications. The worst is out of date documentation. I think the unspoken understanding is that blogs and forums will pick up the slack. Inexcusable!

要查看或添加评论,请登录

Mark Swinden的更多文章

  • NEVER FORGET (or have we)

    NEVER FORGET (or have we)

    Over the next few days, you will undoubtedly hear a ton about the 20th anniversary of the 9|11 terrorists attack on…

    3 条评论
  • Working From Home - It's Not for Everyone

    Working From Home - It's Not for Everyone

    I've been working from home for many years; both as an employee of a company and as a business owner myself. So, if…

    5 条评论
  • Creating Successful Learning Projects with the CIA Method

    Creating Successful Learning Projects with the CIA Method

    When creating any type of learning project, the design of the project is almost as important as the actual content…

    4 条评论
  • It’s Giveaway Time

    It’s Giveaway Time

    OK folks, it’s contest time…and just in time for Christmas! The below pictured Messenger Bag could be yours and all you…

    1 条评论
  • ASTROS 2020 Redemption

    ASTROS 2020 Redemption

    This loss is a hard one to swallow. Astros' fans everywhere would have bet the farm on us winning it all this year…

    27 条评论
  • ATS SUCKS! MY RESUME WINS

    ATS SUCKS! MY RESUME WINS

    ATS SUCKS! For those that aren't familiar with ATS, let me explain. ATS stands for Applicant Tracking System.

    24 条评论
  • That's It, I Quit!

    That's It, I Quit!

    UPDATE AT BOTTOM - 08/30/2019 A lot of people have been asking, "how did you quit"? "What method did you use"? So, I…

    9 条评论
  • Engineer vs Seasoned Technical Writer?

    Engineer vs Seasoned Technical Writer?

    Make no mistake; engineers are a key component to turning out quality documentation for your end-users, but are they…

    16 条评论
  • Documentation Got You Down?

    Documentation Got You Down?

    Ever seem like your equipment or service supporting documentation always takes a back seat? Why is that? Let's face it,…

社区洞察

其他会员也浏览了