Quickstart guide: Difference between revisions

Revision as of 00:15, 25 January 2019

Revision as of 01:25, 23 April 2019

Line 1:

A '''quick start guide''' or '''quickstart guide''' ('''QSG''') is in essence a shortened version of a [[User guide|manual]], meant to make a buyer familiar with his or her [[Product (business)|product]] as soon as possible. This implies the use of a concise step-based approach that allows the buyer to use a product without any delay, if necessary including the relevant steps needed for installation. A Quick Start Guide, or QSG for short, focuses on the most common instructions, often accompanying such instructions with easy-to-understand [[Illustration|illustrationsillustration]]s.<ref name=”Tips”"Tips"> [http://www.idratherbewriting.com/2008/12/31/quick-reference-guide-formats-tips-for-finding-attractive-layouts/ "Quick Reference Guide Formats: Tips for Finding Attractive Layouts." Dec 31, 2008.]</ref><ref name=”Sweet”"Sweet"> [http://www.idratherbewriting.com/2009/04/10/quick-reference-guides-short-and-sweet-documentation/ "Quick Reference Guides: Short and Sweet Documentation." April 10, 2009.]</ref> The appearance of a QSG can vary significantly from product to product and from manufacturer to manufacturer. For example, it could be a single A4 sheet, a folded card or a booklet consisting of only a few pages.<ref name=”Tips”"Tips" /><ref name=”Sweet”"Sweet" />

[[Image:Sample quick start guide (radio).jpg|thumb|link=https://www.manualise.com/en/examples-quick-start-guides/#example|250px|A sample quick start guide for a radio]]

==Background ==

Quick Start Guides are becoming more popular by the day, mainly because of the growing complexity of consumer products such as television sets, cell phones, cars and software applications. This growing complexity has led to manuals that are constantly growing in size, making them less attractive to read. <ref name=”Sweet”"Sweet" /><ref name=”Poetry”"Poetry"> [http://www.idratherbewriting.com/2008/07/06/quick-reference-guides-the-poetry-of-technical-writing/ "Quick Reference Guides: The Poetry of Technical Writing." July 6, 2008.] </ref>

A QSG should solve this problem: not only by focusing on the most basic instructions, but also by using visual information that is easy to understand. This approach should save time on the part of the user, giving him less stress while at the same time contributing to his self-confidence.<ref name=”Sweet”"Sweet" /><ref name=”Poetry”"Poetry" /> As a result, users may conclude that using a product is not as difficult as they initially might have thought, hopefully leading to a growing willingness to tackle more complex tasks and, thus, exploring the product to the fullest of its extent.<ref name=”Sweet”"Sweet" />

==Relevance==

When [[Industrial design|designing]] a QSG, the most important question is how to filter out the most basic instructions that are the most useful to the average user.<ref name=”Sweet”"Sweet" /><ref name=”Poetry”"Poetry" /> The answer to this question primarily depends on two things: the ability of the [[Technical writer|QSG writer]] to place himself in the shoes of the user and the product itself. As for the latter: a product that basically only needs some instructions to install it properly after which it functions continuously, is relatively easy to ‘capture’ in a QSG. Also, products that offer a broad variety of tasks of which in reality only a few really matter, lend themselves for a QSG.<ref name=”Poetry”"Poetry" /> An example of such a product would be a [[Application software|software application]]. If the main tasks in such an application would be not more than a handful, then a QSG on a double-sided card could be an effective solution. If tasks would become more complicated of nature, one can refer to the complete manual.

==Requirements==

The requirements for setting up a Quick Start Guide are not set in stone. It is up to the technical writer to become familiar with the mindset of the user, as well as with the character of the product. This being said, there is indeed a legal obligation, namely to refer to the complete manual (see the international IEC-82079 standard). Also, it is imperative to include [[Safety|instructions for safe use]] of the product in any QSG.

==See also==