Employee/Customer Onboarding, Training and Enablement

10 Examples of Great End User Documentation

Jonathan DeVore - Feb 17, 2014 1:00:00 PM

In a previous article, I went over 14 examples of documentation mistakes you might be making. Today, I'm going to show you 10 examples of what makes great end user documentation.

I should clarify that end user documentation does not serve the same purpose as technical documentation, so you shouldn't write them the same way. Technical documentation is meant to teach somebody everything there is to know about a subject, whereas end user documentation is meant to just show somebody the necessary steps to accomplish a task and answer "How to..." questions.

The examples I show are examples of what makes great end user documentation.

Topics: Software Documentation Tips- Documentation Managers

Read More

Increase Productivity at Work by Making a Checklist

jdevore - Jan 29, 2013 11:58:00 AM

In his book The Checklist Manifesto - How to Get Things Right,"Atul Gawande showed us how simple it is to deal with complex processes, and consistently perform operations correctly.

Just use a checklist.

And we agree with him. If you want to increase productivity at work, you need to create checklists for how to accomplish tasks. This will not only serve as helpful reminders for you when you're performing tasks, but it also makes it a lot easier to delegate tasks and get consistently good results.

Topics: Software Documentation Tips- Turnkey Business- Documentation Managers

Read More

If You Want to Increase Productivity At Work, You Need to Get Organized

jdevore - Jan 9, 2013 7:10:00 PM

I've done a lot of service projects in my life, and I've found that about 80% of the time, way too many people show up.

It's not that there isn't a lot of work to do, it's just that whoever is in charge isn't organized in a way that they can utilize all of the available resources - lots of manpower, little direction. In fact, it often turns into 15 people walking around watching the person we were supposed to be serving, doing all of the work! That's not very helpful.

So when my brother Trevor and I accompanied a group to New Jersey to help out with the Hurricane Sandy cleanup effort, I was shocked by how well we were utilized! Our group of 128 was immediately put to work, and able to help those who desperately needed it within an hour of showing up. Our productivity was dramatically increased because the group we went with was organized.

Topics: Software Documentation Tips- Entrepreneurship- Documentation Managers

Read More

The Ultimate How-to Guide for Creating Killer Documentation

Greg DeVore - Feb 16, 2012 7:12:00 AM

We have been talking a lot lately about the importance of providing road maps for our customers. As we looked at our own customer education material we realized that while we offered a lot of documentation tips, we didn't have a clear guide that helped our customers establish and implement a successful documentation strategy.

Some customers were able to piece together a complete strategy from the articles we produced, but to do so they had to bounce around to a lot of different places.

Topics: Software Documentation Tips- Customer Success- Documentation Managers

Read More

Docs that Rock Whiteboard Video: Do it, Don't Finish It

Greg DeVore - Feb 2, 2012 4:29:00 AM

Too many people think of software documentation as a project they will complete as opposed to a process they will establish. Software documentation projects almost always fail. They fail to meet the real needs of users. They fail to provide up-to-date information. They fail to deliver real business results.

The key to creating great docs is to abandon projects and instead establish a documentation process.

I explain the details of how you can accomplish this in the short video below. The tips I share in this video are what our most successful customers use to make software documentation a key part of their business strategy.

Topics: Software Documentation Tips- Documentation Managers

Read More

3 Tips for Keeping Your Documentation Up to Date

Greg DeVore - Jan 25, 2012 5:49:00 AM

As a user, nothing is more frustrating than reading instructions that are out of date. Help files that describe buttons, icons or features that simply don't exist anymore are one of the cruelest things any organization can inflict upon its users.

Unfortunately it is all too common. How often do your update your docs? What if you GPS was only updated as often as your documentation?



Topics: Software Documentation Tips- Customer Support- Documentation Managers

Read More

Road maps and Roadblocks

Greg DeVore - Jan 5, 2012 7:59:00 AM

Without clear goals your software documentation is bound to fail. Recently we have started thinking of our documentation in two contexts:

  1. Documentation that provides a road map
  2. Documentation that removes roadblocks

Topics: Software Documentation Tips- Customer Support- Customer Success- Documentation Managers

Read More

The Hidden Power of an Online Manual

Greg DeVore - Nov 18, 2011 7:08:00 AM

Do you answer yes to any of these questions?

  • Is your customer support group inundated with repetitive requests for the same information?
  • Are your employees clamoring to find out the details of your company’s new policies?
  • Do you need to efficiently and effectively train new clients on the use of your product?
  • Do you need to train your employees on the technology products you use to run your business?

Managing knowledge bases without an easy way for groups of people to access them can suck productivity out of your business. If your customers and employees are constantly scrambling to find the information they need you need to consider the hidden power of an online manual.

Online manuals centralize all of your pertinent data for specific groups. Whether it is a customer support manual, an employee handbook, a research guide, a lesson plan, an employee hiring test or a product tutorial guide, online manuals can solve your problems of distributing information to a large or small audience.

Compare this to what a lot of organizations are doing - locking their knowledge in PDF and Word files. Capturing your organization's knowledge in these formats makes that knowledge hard to access and hard to update.

Topics: Software Documentation Tips- Documentation Managers

Read More

What if your GPS acted like a typical user guide?

Greg DeVore - Oct 18, 2011 1:19:00 PM
We have all experienced the frustration of wading through wordy, unclear documentation, just trying to find the information we needed. For some reason some authors believe that we need to know the life history of an application before we are allowed to do anything with it.

We created this video to show what life would be like if GPS units treated us the same way. Enjoy!

Topics: Software Documentation Tips- Documentation Managers

Read More

Screencasts vs. ScreenSteps vs. Single Image Capture

Greg DeVore - May 20, 2011 4:40:00 AM

A question was recently posted on Twitter, "@donmcallister @podfeet opinions on what problems are best solved by/use cases for Mac apps such as ScreenSteps, Screenflow, Skitch, others?"

We get that question a lot. We answered it in depth in a webinar we did last year titled "Video, Screencasts and Still Images - Using the Right Tool at the Right Time." But for those who are interested in a shorter answer, here it is. These are some simple rules that we use.

Topics: Software Documentation Tips- Documentation Managers

Read More

Free Training Tips

Subscribe For Employee Training Best Practices

We talk about rollout training, onboard training, and writing better standard operating procedures

Subscribe to Email Updates

100% Privacy. No Spam.