audiosite
  • Home
  • Blog
  • Contact
    • Forums
  • Audio Engineering
    • OSX audio
    • Studio Recording >
      • Loudness Wars
      • Analogue Tape
      • Recording History
    • Pro Tools
    • Sound for Picture
    • Sound Theory
    • Practical Acoustics
    • Surround Sound
    • Speakers & Amplifiers >
      • Headphones
    • Electronics
    • Snake Oil
  • Music Technology
    • Music Theory
    • MIDI
    • Synthesis
    • Sampling
    • Logic >
      • Environment
  • Keyboards
    • KX88
    • SV-1
    • P2000
    • PC3
    • ETI Synth
    • T200
    • DX7
    • PolyMoog
    • Vintage Synths
    • Vox Jaguar
  • Odds and Sods
    • Vinyl
    • Recording History
    • Calculators
    • LPFM Radio
    • Free Stuff >
      • Freeware
      • eBooks
    • Books
    • Church Sound
    • Sibelius
    • Maths
    • Guitar
    • UK visit 1999
  • Search
  • Links
    • Video Tutorials
    • Search Engines
    • Magazines
    • Sound Theory
    • Acoustics >
      • Psycho-Acoustics
    • Electronics
    • Loudspeakers
    • MIDI >
      • Jingles
      • Synthesis
    • Studio Recording >
      • Analogue Recording
      • NZ Studios
      • Digital Recording
    • Music Theory >
      • Songwriting
      • Western & World Music
    • Radio
    • Sound for Picture
    • Multimedia
    • Music Industry
    • Music & Culture
  • Site Map

equipment manuals

21/8/2012

0 Comments

 
In these days of on-line help files, the art of manual reading seems to be getting lost. Here a a few pointers:
Operating Manuals (opmans) can offer: 
  • background information (on the subject pertaining to the device)
  • equipment description (features, architecture, connections, use, operating conditions)
  • operating instructions (eg step by step instructions, tutorials)
  • specifications
  • troubleshooting (eg error codes)
  • maintenance
  • update and accessory information

So, what makes a good manual? I'll begin answering that by pointing out some bad examples: 
  • too little information - some manuals are little more than a sales brochure
  • too much information (eg the opman includes a full technical repair section)
  • information pitched at the wrong level - you don't really want a kiddie version manual with a piece of pro gear. Nor should the manual assume you have a degree for a piece of hobby gear.
  • poor English - a lot of products are oriental, so translation is important. It takes quite some time for a country to develop these language skills to a good standard.
  • misleading information (eg "sales talk")
  • insufficient or poor quality diagrams - with equipment manuals a picture really is worth a thousand words
  • sections not in a good order, or a poor contents and/or indexing


To be fair, it is not that easy to write a really good opman. If you don't believe me try writing some simple instructions for, say, changing a car wheel. Your first attempt will almost certainly have the user come back and query some part of it. After a revision or two it will probably be ok. It is even more difficult when a manufacturer writes a manual for a piece of equipment. Many items we buy these days are complex and several different departments are involved in the design and build (eg software engineers, hardware engineers, production team, marketing dept.). They will all have their in-house documentation but just hobbling together bits of information from the various teams will not make a very good opman. Luckily, the pioneering age for the opman is now over (at least in the West), and decent manufacturers realise that an extra team is needed for generating all the manuals. However, more and more equipment is being manufactured in the startup industrialised nations of Asia. They are still at the stage of thinking of the manual as an afterthought, or perhaps an inconvenience. This will change (probably when they realise that, just like slick packaging, quality documentation can add value to the product).

A good manual, therefore, has:
  • simple explanations (ie only as complicated as need be)
  • concise text
  • pictures (preferably colour)
  • one language only (multi-language opmans are often hard to follow)
  • a glossary
  • humour (eg Mackie manuals)
  • an overview
  • well defined sections
  • application examples
  • accompanying DVD/ CD-ROM
  • supplier contact details (for your country)

ok, maybe that last one is superfluous now that every company has a website.

Here is how I used to read manuals: 

  1. When I get a new piece of equipment I leave it in the box until I have read the manual right through. This is called delayed gratification, and is proven to be a winning strategy in life.
  2. Next I go through any tutorial provided while using the equipment.
  3. Finally, I refer back to the manual as a reference, using the applicable section (I can find the information quickly as I have already read the entire manual).

This was all well and good back when manuals were no longer than 30 pages. This is still the case for some hardware but software is a different story. With the manuals spanning several volumes and totalling thousands of pages, it no longer makes sense to do no.1 so after reading the install docs I will cut to the chase and start on no. 2. The downsides of this are that not having read the whole manual I can easily miss out on some of the features the software provides, and it is not nearly so easy to find information when I get stuck. But there you go, that's progress for you.
In any case, don't throw the manual out with the packaging. If you want to be a Power-user of your gear, start reading the manuals.
0 Comments



Leave a Reply.

    Author

    Richard Hallum
    NZCE, MMusTech, Dip Tch (Ter).
    memberships: APRA, AES, 
    NZ Acoustical Society, ALMA.

    Archives

    June 2017
    August 2016
    September 2015
    November 2014
    May 2014
    March 2014
    December 2013
    November 2013
    October 2013
    September 2013
    August 2013
    July 2013
    June 2013
    May 2013
    April 2013
    March 2013
    February 2013
    January 2013
    December 2012
    November 2012
    October 2012
    September 2012
    August 2012
    July 2012
    June 2012
    May 2012
    April 2012
    March 2012
    February 2012
    January 2012
    December 2011
    November 2011
    September 2011
    August 2011
    July 2011
    June 2011
    May 2011
    April 2011
    March 2011
    February 2011
    January 2011
    December 2010
    November 2010
    October 2010
    September 2010
    August 2010
    July 2010
    June 2010
    May 2010

    Categories

    All
    Acoustics
    All
    Anything Else
    Audio Engineering
    Keyboards
    Leprechauns
    Music

Powered by Create your own unique website with customizable templates.