135:
27:
153:
As the software industry was developing, the question of how to best document software programs was undecided. This was a unique problem for software developers, since users often became frustrated with current help documents. Some considerations for writing a user guide that developed at this time
191:
to users (staff, students...), organized into steel binders, locked together in one monolithic steel reading rack, bolted to a table or counter, with pages organized for modular information updates, replacement, errata, and addenda.
489:
199:
are book-like documents with contents similar to the above list. They may be distributed either in print or electronically. Some documents have a more fluid structure with many internal links. The
239:
applications, where groups of users have access to only a sub-set of the application's full functionality, a user guide may be prepared for each group. An example of this approach is the
46:, is intended to assist users in using a particular product, service or application. It's usually written by a technician, product developer, or a company's customer service staff.
49:
Most user guides contain both a written guide and associated images. In the case of computer applications, it is usual to include
184:
150:
in the year 1900. On the cover of this device are passages of text which describe the features and operation of the mechanism.
339:
134:
95:
A Scope section is crucial as it also serves as a disclaimer, stating what is out-of-scope as well as what is covered
517:
212:
92:
An
Audience section to explicitly state who is the intended audience who is required to read, including optionals
383:
304:
467:
210:
is often applied to a document that addresses a specific aspect of a software product. Some usages are
83:
A preface, containing details of related documents and information on how to navigate the user guide
89:
A Purpose section. This should be an overview rather than detail the objective of the document
143:
366:
Proceedings of the 1st annual international conference on
Systems documentation - SIGDOC '82
146:, a 2,000 year old Greek analogue computer that was found off the coast of the Greek island
251:
196:
8:
105:
section detailing possible errors or problems that may occur, along with how to fix them
53:
of the human-machine interface(s), and hardware manuals often include clear, simplified
427:
389:
299:
265:
123:
410:
McKee, John (August 1986). "Computer User
Manuals in Print: Do They Have a Future?".
379:
279:
236:
20:
431:
419:
393:
369:
294:
258:
26:
102:
319:
309:
159:
511:
364:
Chafin, Roy (January 1982). "User manuals: What does the user really need?".
284:
201:
374:
245:
147:
445:
423:
188:
50:
142:
User guides have been found with ancient devices. One example is the
31:
340:"Boffins decipher manual for 2,000-year-old Ancient Greek computer"
289:
241:
119:
58:
138:
The user guide engraved into a model of the
Antikythera Mechanism.
195:
User manuals and user guides for most non-trivial PC and browser
54:
227:
62:
98:
A guide on how to use at least the main function of the system
314:
180:
109:
187:, mainframe documentation were printed pages, available
174:
19:
For a full guide to an item owned by its operator, see
412:
ACM SIGDOC Asterisk
Journal of Computer Documentation
468:"Getting Started with Picasa: Getting Started Guide"
167:
the role of printed user guides for digital programs
509:
57:. The language used is matched to the intended
115:Where to find further help, and contact details
73:The sections of a user manual often include:
68:
65:kept to a minimum or explained thoroughly.
373:
133:
25:
206:is an example of this format. The term
510:
363:
409:
405:
403:
359:
357:
355:
175:Computer software manuals and guides
13:
249:document, which contains separate
14:
529:
400:
352:
16:Technical communication document
80:A title page and copyright page
482:
460:
438:
332:
122:and, for larger documents, an
1:
490:"Autodesk Topobase 2010 Help"
325:
164:length and reading difficulty
112:(Frequently Asked Questions)
7:
305:Instruction manual (gaming)
273:
42:, also commonly known as a
10:
534:
225:guides. An example is the
129:
18:
446:"Google Earth User Guide"
69:Contents of a user manual
518:Technical communication
139:
35:
375:10.1145/800065.801307
230:Getting Started Guide
219:Getting Started Guide
197:software applications
144:Antikythera Mechanism
137:
29:
170:user-centered design
424:10.1145/15505.15507
30:User's guide for a
368:. pp. 36–39.
300:Manual page (Unix)
140:
36:
237:business software
525:
502:
501:
499:
497:
486:
480:
479:
477:
475:
464:
458:
457:
455:
453:
442:
436:
435:
407:
398:
397:
377:
361:
350:
349:
347:
346:
336:
295:Technical writer
533:
532:
528:
527:
526:
524:
523:
522:
508:
507:
506:
505:
495:
493:
488:
487:
483:
473:
471:
466:
465:
461:
451:
449:
444:
443:
439:
408:
401:
386:
362:
353:
344:
342:
338:
337:
333:
328:
276:
183:, for example,
177:
132:
103:troubleshooting
86:A contents page
71:
24:
17:
12:
11:
5:
531:
521:
520:
504:
503:
481:
470:. 15 June 2009
459:
437:
399:
384:
351:
330:
329:
327:
324:
323:
322:
320:HOWTO articles
317:
312:
310:Reference card
307:
302:
297:
292:
287:
282:
280:Owner's manual
275:
272:
244:Topobase 2010
221:, and various
176:
173:
172:
171:
168:
165:
162:
160:plain language
131:
128:
127:
126:
116:
113:
106:
99:
96:
93:
90:
87:
84:
81:
78:
70:
67:
21:Owner's manual
15:
9:
6:
4:
3:
2:
530:
519:
516:
515:
513:
491:
485:
469:
463:
448:. 4 June 2009
447:
441:
433:
429:
425:
421:
417:
413:
406:
404:
395:
391:
387:
381:
376:
371:
367:
360:
358:
356:
341:
335:
331:
321:
318:
316:
313:
311:
308:
306:
303:
301:
298:
296:
293:
291:
288:
286:
285:Release notes
283:
281:
278:
277:
271:
269:
267:
262:
260:
255:
253:
252:Administrator
248:
247:
243:
238:
233:
231:
229:
224:
220:
216:
214:
209:
205:
203:
198:
193:
190:
186:
182:
169:
166:
163:
161:
157:
156:
155:
151:
149:
145:
136:
125:
121:
117:
114:
111:
107:
104:
100:
97:
94:
91:
88:
85:
82:
79:
76:
75:
74:
66:
64:
60:
56:
52:
47:
45:
41:
33:
28:
22:
494:. Retrieved
484:
472:. Retrieved
462:
450:. Retrieved
440:
418:(2): 11–16.
415:
411:
365:
343:. Retrieved
334:
264:
257:
250:
240:
234:
226:
222:
218:
213:Installation
211:
207:
202:Google Earth
200:
194:
178:
152:
141:
77:A cover page
72:
48:
43:
39:
37:
266:Developer's
158:the use of
148:Antikythera
51:screenshots
44:user manual
492:. Autodesk
385:089791080X
345:2018-11-29
326:References
204:User Guide
189:on-premise
40:user guide
496:13 August
474:13 August
452:13 August
154:include:
32:Dulcitone
512:Category
432:35615987
290:Moe book
274:See also
263:, and a
242:Autodesk
235:In some
120:glossary
59:audience
55:diagrams
34:keyboard
394:6435788
179:Before
130:History
61:, with
430:
392:
382:
261:Guides
254:Guides
228:Picasa
223:How to
63:jargon
428:S2CID
390:S2CID
268:Guide
215:Guide
208:guide
124:index
498:2009
476:2009
454:2009
380:ISBN
315:RTFM
259:User
246:Help
185:GCOS
181:Unix
420:doi
370:doi
110:FAQ
514::
426:.
416:12
414:.
402:^
388:.
378:.
354:^
270:.
256:,
232:.
217:,
118:A
108:A
101:A
38:A
500:.
478:.
456:.
434:.
422::
396:.
372::
348:.
23:.
Text is available under the Creative Commons Attribution-ShareAlike License. Additional terms may apply.