Good manuals are good business

You can read and learn and experiment... or work with me to get the immediate benefit of 20 years' experience in strategy, copywriting, design, development and publishing. I create affordable sales, training and community websites that work!

My initial 30 minute consultation is free, and I provide fixed quotes for projects, so you don't go over budget.

Good technical support is good business

What is the cost of daily calls to your helpline, a bad review or a lost customer. Compare that to the once-off cost of adding a quick start guide, a YouTube video or some extra FAQs to your website?

Bad support is bad business:

  • 90% of the power of your amazing equipment or software goes unused
  • endless support calls from upset customers
  • frustrated call centre staff who answer the same questions over and over
  • a poor reputation for service
  • lost sales due to bad mouthing or a lack of referrals

Happy users are the future of your business. If your equipment is easy to use, and does the job, they won’t consider looking at a cheaper competitor.

We all like to believe we are tech savvy. The honest truth is most of us struggle daily with our mobile phones, computers and appliances! We rarely use the advanced features.

Tips to improve Design

  • YES, you need a clickable table of contents. preferably automated to save you updating.
  • YES, you need an active search.
  • YES, you need great navigation.
  • Keep headers, numbers, fonts and colours consistent and legible.
  • Convert text and tables to diagrams, charts and infographics.
  • Break up long, grey blocks of text with relevant photos.
  • Redesign page layouts to make them legible and memorable.

Tips to improve wording

  • Hire a technical editor. They will restructure, shorten, and find errors.
  • Use plain English (Flesch-Kincaid Test Level 6 or better).
  • Make sure there is a clear structure, logic and flow.
  • Put details or examples into visually-distinct “blockquotes”
  • Use short, active, punchy sentences that start with a noun.
  • Get rid of acronyms, jargon or slang.
  • Be sensitive to ethnicity, disability and gender.
  • Read a few paragraphs aloud – is this how people really speak?

Software Manuals

Software companies complain that users expect to push the “install” button on sophisticated software without so much as opening the manual. But the manual is dead boring – and little more than a list of available menu items.

It’s digital – why are you trying to save paper?

In an effort to keep the manual small, technical writers don’t explain “old” features and focus on the new one. If you have used the software for year, this makes sense.

But what about the new users who haven’t used your product before?  You need to allow for beginners, without talking down to expert users.

The easiest way to deal with varied skill levels is to split your manual into sections. Create a quick start guides with images for beginners, and videos for those doing complex tasks.

How do your build a reputation for good support

Many customers assume 24/7 support is part of the price. How do you build a reputation for “delivery” without spending all your profits on support staff?

Take your support online

  • Avoid big PDF files. PDFs are for situations where you need a printed reference guide
  • Convert presentations to videos – most people find videos easier.
  • Let buyers register online for software, product ownership or warranties. Now you have contact details and a mailing list to promote new features and products!
  • Users should ALWAYS register to get access to details that might reveal intellectual property
  • QR codes are quicklinks to webpages you can scan with a mobile phone.  Create product stickers with QR code links to that product’s online help files.
  • FAQs (common questions) should be set up to evolve.  Let users add new questions that your team and trusted users can answer.
  • Let users report and track their bugs and issues online. Do not use Facebook – you can’t control it!  Don’t use github unless your users are tech pros.
  • Build a mailing list. Email tips to users by level and type.
  • Always announce bugs quickly – don’t hide the problem
  • Set up online training events that promote good use and show off new features
  • Ask users for what feature they would like to see next – you might get some easy wins!
More on this topic