SlideShare ist ein Scribd-Unternehmen logo
1 von 28
A Presentation on
Instruction Manual and
Technical Description
Presented by –
Kashif (2010024)
Wali Ahmed(2010030)
Sumit Kumar Singh(2010013)
Table of Contents
1. What is an Instruction Manual?
2. Types of instruction Manuals
3. Why is Instruction Manual required?
4. The characteristics of a good Instruction Manual
5. Information contained in the Instruction manual
6. The format of an Instruction Manual
7. General guidelines for Writers.
8. How to create a great first impression.
9. How to enhance findability.
10. A sample of Instruction Manual.
What is an Instruction Manual?
• An instruction manual (also called an owner’s manual)
is an instructional book or booklet that is supplied with
almost all technologically advanced consumer products such
as vehicles, home appliances and computer peripherals.  It
is usually written by a technical writer.
• Most user guides contain both a written guide and the
associated images. In the case of computer applications, it
is usual to include screenshots of how the program should
look, and hardware manuals often include clear,
simplified diagrams.
Types of Instruction Manual
Not restricted to the printed page –
– Online help systems
– Online Instruction Manual
– Multimedia -Video, CD, DVD or audio tape.
Why is Instruction Manual
required?
• Minimises confusion
• Provide essential support for the system
• Aids in the ongoing operation and maintenance of the
system
• Enables the system to be kept effective for the long term
• Self-preservation
Good Instruction Manual has a…...
• Purpose
Why this manual is developed?
• Subject
Description of what the system is?
What it does and how it does it?
• Audience 
Owners, designers, builders, users
Those who provide support and revise the system
- Information contained in the Instruction manual
typically includes: 
• Safety instructions; for liability reasons these can be extensive, often
including warnings against doing things that no intelligent person would
consider doing.
• Assembly instructions; for products arrive in pieces for easier shipping.
• Installation instructions; for productions that need to be installed in a
home or workplace.
• Normal usage instructions.  
Information contained in the
Instruction manual
Information contained in the
Instruction manual cont. ….
• Programming instructions; for microprocessor controlled products such
as VCRs, programmable calculators, and synthesizers.
• Maintenance instructions.
• Troubleshooting instructions; for when the product does not work as
expected.
• Service locations; for when the product requires repair by a factory
authorized technician.
• Product Technical Specifications.
• Warranty information; sometimes provided as a separate sheet.
Format
– Bullet numbered lists
• Use numbers only if necessary for identification, numbers can be
confusing.
• Be careful not to let list dominate the page.
3.0
3.1
3.1.1
3.1.2
3.1.2.1
3.1.2.2
3.2
Title
Subtitle
Topic
Note
Topic
Topic
Subtitle
Subtitle
The sections of a user manual often include:
• A cover page.
• A title page and copyright page.
• A preface, containing details of related documents and information on
how to navigate the Instruction manual.
• A contents page.
• A guide on how to use at least the main functions of the system.
• A troubleshooting section detailing possible errors or problems that may
occur, along with how to fix them.
• A FAQ (Frequently Asked Questions).
• Where to find further help, and contact details.
• A glossary and, for larger documents, an index.
Format cont. ....
General guidelines for
Writer
1. Include a one-page quick start guide.    
2. Present instructions as step-by-step procedures.
3. Tell the user what functions there are, and what they are for — not just
how to use them.
4.    Ensure that the writers are part of the product design team.
5. Consider the needs of disabled users (i.e., low vision, color-blind) and
provide alternative manuals in Braille, large print, audio etc.
6. Do not assume the user has prior experience or product knowledge.  
7. Use everyday words and terms: avoid jargon.
How to create a great first
impression
1. Avoid a text-book look.
2. Make purposeful and effective use of color.
3. Make effective use of pictures and diagrams.
4. Include a help-line number.
5.    Use a single language.
How to enhance findability
1. Organize information hierarchically.
2. Denote importance by using contrast, color, shading, emboldening etc.
3. Provide a key word index using the terminology of the user.
4. Provide a glossary of technical terms.
5. Include a (genuinely useful) trouble-shooting section.
6.    Clearly display the help-line number.
What is Technical Description ?
• Technical Description is the process of
defining or describing a technical object,
concept, or process to someone who has little
knowledge or experience .
• We all use the word description loosely to
refer to practically any discussion or
explanation. But in this context, it means ”the
detailed discussion of the physical aspects of a
thing”.
When Technical Description should
take place ?
• Technical descriptions are used –
o Before products and processes are developed (as
part of proposals and planning documents).
o During development (in progress reports, for
instance.
o Afterwards (as part of marketing and promotional
literature and technical support documents).
Types of Technical Description
-
Technical Description is of two types-
I.Product Description.
II.Process Description.
Product Description
• A product description explains the
features of a specific device, like a
scientific instrument or computer
program. Possible topics include
devices that are specific to your field,
or devices you use in everyday life.
Example How to use different
modules of a computer program.
Example Of Product Description for
Lenovo Y560 Laptop
• Genuine Windows 7 Home Premium
• 15.6 inch HD LED Backlit display″
• Intel Core i7/i5/i3 Processor
• ATI Radeon HD 5730 1GB Dedicated Graphics
• up to 8GB DDR3 RAM
• up to 500GB (7200RPM) Hard Disk
• Blu Ray Optical Drive
• Intel WiMax 6250/6200 a/g/n Wi-Fi
• Bluetooth
• 6-in-1 Memory Card Reder
• 1.3MP Webcam
• 3xUSB 2.0, HDMI Connector
• 6 cell Li-ion Battery
• Weight: 2.7 Kg
Process Description
• A process description explains how
a complex event occurs, including a
mechanical process. You can
choose a process that is specific to
your field, or one that people may
be curious about:
• i.e. how modules are developed,
strategy used, algorithms etc.
Example Of Process Description
• Tasks.
• Input.
• Desired Output.
• Personnel Involved.
How To Write ?
• Overview of Item
o Definition of the object—
identification and function.
o Identification of major parts.
Contd..
• Description and Function of Parts (repeated
as necessary for multiple
parts)
1. Definition—identification and function
2. Composition—shape, dimensions, and materials
3. Subparts
4. Relationship to and method of attachment to
adjacent parts
Contd..
• Operation of Item
1. Summary of parts if necessary.
2. Explanation of one “cycle of operation”.
• Maintenance Of Item
1. Simple care steps.
2. What to do and what don’t.
3. Simple steps of precautions.
Contd..
• Operational Environment
1. Things needed for that product.
2. Operational Temperature, humidity etc..
Refrence
• www.wikipedia.com
• www.wikianswer.com
• www.getsupport.com
• www.supportforu.com
Im presentation

Weitere ähnliche Inhalte

Ähnlich wie Im presentation

Intro to User Centered Design Workshop
Intro to User Centered Design WorkshopIntro to User Centered Design Workshop
Intro to User Centered Design WorkshopPatrick McNeil
 
Documentation Plan Example
Documentation Plan ExampleDocumentation Plan Example
Documentation Plan ExampleGreg Turnbull
 
Mobile Project Management
Mobile Project ManagementMobile Project Management
Mobile Project ManagementLee Schlenker
 
Impact of-accessibility-on-technical-writing
Impact of-accessibility-on-technical-writingImpact of-accessibility-on-technical-writing
Impact of-accessibility-on-technical-writingMohammad Qais Mujeeb, PMP
 
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016IXIASOFT
 
Cs8092 computer graphics and multimedia unit 5
Cs8092 computer graphics and multimedia unit 5Cs8092 computer graphics and multimedia unit 5
Cs8092 computer graphics and multimedia unit 5SIMONTHOMAS S
 
Introduction to User Experience Design for Engineers
Introduction to User Experience Design for EngineersIntroduction to User Experience Design for Engineers
Introduction to User Experience Design for EngineersICS
 
Equipment manual writing may, 2014 final
Equipment manual writing may, 2014 finalEquipment manual writing may, 2014 final
Equipment manual writing may, 2014 finalbb2koontz
 
User Experience Design for Software Engineers, ICS & The Qt Company
User Experience Design for Software Engineers, ICS & The Qt CompanyUser Experience Design for Software Engineers, ICS & The Qt Company
User Experience Design for Software Engineers, ICS & The Qt CompanyQt
 
Introductiontousability 090407053727-phpapp02
Introductiontousability 090407053727-phpapp02Introductiontousability 090407053727-phpapp02
Introductiontousability 090407053727-phpapp02Techved Consulting
 
Software Engineering an Introduction
Software Engineering an IntroductionSoftware Engineering an Introduction
Software Engineering an IntroductionAjit Nayak
 
User Console Essentials
User Console EssentialsUser Console Essentials
User Console EssentialsDell World
 
Your questions answered
Your questions answeredYour questions answered
Your questions answeredekm4web
 
Software development lifecycle
Software development lifecycleSoftware development lifecycle
Software development lifecycleRebecca Jones
 
Building products people actually can use – why all developers need to unders...
Building products people actually can use – why all developers need to unders...Building products people actually can use – why all developers need to unders...
Building products people actually can use – why all developers need to unders...Cyber-Duck
 
unit5_usability.pptx
unit5_usability.pptxunit5_usability.pptx
unit5_usability.pptxSrilekhaK12
 
Targeted documentation
Targeted documentationTargeted documentation
Targeted documentationAlyssa Fox
 
Sharpest tool in the box: Choosing the right authoring tool for your learning...
Sharpest tool in the box: Choosing the right authoring tool for your learning...Sharpest tool in the box: Choosing the right authoring tool for your learning...
Sharpest tool in the box: Choosing the right authoring tool for your learning...Brightwave Group
 

Ähnlich wie Im presentation (20)

merged (1).pdf
merged (1).pdfmerged (1).pdf
merged (1).pdf
 
Intro to User Centered Design Workshop
Intro to User Centered Design WorkshopIntro to User Centered Design Workshop
Intro to User Centered Design Workshop
 
Documentation Plan Example
Documentation Plan ExampleDocumentation Plan Example
Documentation Plan Example
 
Mobile Project Management
Mobile Project ManagementMobile Project Management
Mobile Project Management
 
Impact of-accessibility-on-technical-writing
Impact of-accessibility-on-technical-writingImpact of-accessibility-on-technical-writing
Impact of-accessibility-on-technical-writing
 
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
 
Cs8092 computer graphics and multimedia unit 5
Cs8092 computer graphics and multimedia unit 5Cs8092 computer graphics and multimedia unit 5
Cs8092 computer graphics and multimedia unit 5
 
Introduction to User Experience Design for Engineers
Introduction to User Experience Design for EngineersIntroduction to User Experience Design for Engineers
Introduction to User Experience Design for Engineers
 
Equipment manual writing may, 2014 final
Equipment manual writing may, 2014 finalEquipment manual writing may, 2014 final
Equipment manual writing may, 2014 final
 
User Experience Design for Software Engineers, ICS & The Qt Company
User Experience Design for Software Engineers, ICS & The Qt CompanyUser Experience Design for Software Engineers, ICS & The Qt Company
User Experience Design for Software Engineers, ICS & The Qt Company
 
Introductiontousability 090407053727-phpapp02
Introductiontousability 090407053727-phpapp02Introductiontousability 090407053727-phpapp02
Introductiontousability 090407053727-phpapp02
 
Software Engineering an Introduction
Software Engineering an IntroductionSoftware Engineering an Introduction
Software Engineering an Introduction
 
User Console Essentials
User Console EssentialsUser Console Essentials
User Console Essentials
 
Your questions answered
Your questions answeredYour questions answered
Your questions answered
 
Software development lifecycle
Software development lifecycleSoftware development lifecycle
Software development lifecycle
 
Building products people actually can use – why all developers need to unders...
Building products people actually can use – why all developers need to unders...Building products people actually can use – why all developers need to unders...
Building products people actually can use – why all developers need to unders...
 
unit5_usability.pptx
unit5_usability.pptxunit5_usability.pptx
unit5_usability.pptx
 
Repairing with DITA - Don Day
Repairing with DITA -  Don DayRepairing with DITA -  Don Day
Repairing with DITA - Don Day
 
Targeted documentation
Targeted documentationTargeted documentation
Targeted documentation
 
Sharpest tool in the box: Choosing the right authoring tool for your learning...
Sharpest tool in the box: Choosing the right authoring tool for your learning...Sharpest tool in the box: Choosing the right authoring tool for your learning...
Sharpest tool in the box: Choosing the right authoring tool for your learning...
 

Mehr von Bhuwanesh Rajbhandari (17)

Training & development lecture8
Training & development lecture8Training & development lecture8
Training & development lecture8
 
Timemanagement
TimemanagementTimemanagement
Timemanagement
 
Tele conferencing and video conferencing
Tele conferencing and video conferencingTele conferencing and video conferencing
Tele conferencing and video conferencing
 
Technical proposal present
Technical proposal presentTechnical proposal present
Technical proposal present
 
Resume
ResumeResume
Resume
 
Research paper
Research paperResearch paper
Research paper
 
Report
ReportReport
Report
 
Report writing abhi
Report writing abhiReport writing abhi
Report writing abhi
 
Preparing a computer friendly rsum
Preparing a computer friendly       rsumPreparing a computer friendly       rsum
Preparing a computer friendly rsum
 
Ppt on decision theory
Ppt on decision theoryPpt on decision theory
Ppt on decision theory
 
Non verbal communication
Non  verbal communicationNon  verbal communication
Non verbal communication
 
Negotiation planning
Negotiation planningNegotiation planning
Negotiation planning
 
Negotiation presentation for website
Negotiation presentation for websiteNegotiation presentation for website
Negotiation presentation for website
 
Impasse & deadlock
Impasse & deadlockImpasse & deadlock
Impasse & deadlock
 
How to write a thesis proposal
How to write a thesis proposalHow to write a thesis proposal
How to write a thesis proposal
 
Appraisal method
Appraisal methodAppraisal method
Appraisal method
 
Strategy.swapnil
Strategy.swapnilStrategy.swapnil
Strategy.swapnil
 

Im presentation

  • 1. A Presentation on Instruction Manual and Technical Description Presented by – Kashif (2010024) Wali Ahmed(2010030) Sumit Kumar Singh(2010013)
  • 2. Table of Contents 1. What is an Instruction Manual? 2. Types of instruction Manuals 3. Why is Instruction Manual required? 4. The characteristics of a good Instruction Manual 5. Information contained in the Instruction manual 6. The format of an Instruction Manual 7. General guidelines for Writers. 8. How to create a great first impression. 9. How to enhance findability. 10. A sample of Instruction Manual.
  • 3. What is an Instruction Manual? • An instruction manual (also called an owner’s manual) is an instructional book or booklet that is supplied with almost all technologically advanced consumer products such as vehicles, home appliances and computer peripherals.  It is usually written by a technical writer. • Most user guides contain both a written guide and the associated images. In the case of computer applications, it is usual to include screenshots of how the program should look, and hardware manuals often include clear, simplified diagrams.
  • 4. Types of Instruction Manual Not restricted to the printed page – – Online help systems – Online Instruction Manual – Multimedia -Video, CD, DVD or audio tape.
  • 5. Why is Instruction Manual required? • Minimises confusion • Provide essential support for the system • Aids in the ongoing operation and maintenance of the system • Enables the system to be kept effective for the long term • Self-preservation
  • 6. Good Instruction Manual has a…... • Purpose Why this manual is developed? • Subject Description of what the system is? What it does and how it does it? • Audience  Owners, designers, builders, users Those who provide support and revise the system
  • 7. - Information contained in the Instruction manual typically includes:  • Safety instructions; for liability reasons these can be extensive, often including warnings against doing things that no intelligent person would consider doing. • Assembly instructions; for products arrive in pieces for easier shipping. • Installation instructions; for productions that need to be installed in a home or workplace. • Normal usage instructions.   Information contained in the Instruction manual
  • 8. Information contained in the Instruction manual cont. …. • Programming instructions; for microprocessor controlled products such as VCRs, programmable calculators, and synthesizers. • Maintenance instructions. • Troubleshooting instructions; for when the product does not work as expected. • Service locations; for when the product requires repair by a factory authorized technician. • Product Technical Specifications. • Warranty information; sometimes provided as a separate sheet.
  • 9. Format – Bullet numbered lists • Use numbers only if necessary for identification, numbers can be confusing. • Be careful not to let list dominate the page. 3.0 3.1 3.1.1 3.1.2 3.1.2.1 3.1.2.2 3.2 Title Subtitle Topic Note Topic Topic Subtitle Subtitle
  • 10. The sections of a user manual often include: • A cover page. • A title page and copyright page. • A preface, containing details of related documents and information on how to navigate the Instruction manual. • A contents page. • A guide on how to use at least the main functions of the system. • A troubleshooting section detailing possible errors or problems that may occur, along with how to fix them. • A FAQ (Frequently Asked Questions). • Where to find further help, and contact details. • A glossary and, for larger documents, an index. Format cont. ....
  • 11. General guidelines for Writer 1. Include a one-page quick start guide.     2. Present instructions as step-by-step procedures. 3. Tell the user what functions there are, and what they are for — not just how to use them. 4.    Ensure that the writers are part of the product design team. 5. Consider the needs of disabled users (i.e., low vision, color-blind) and provide alternative manuals in Braille, large print, audio etc. 6. Do not assume the user has prior experience or product knowledge.   7. Use everyday words and terms: avoid jargon.
  • 12. How to create a great first impression 1. Avoid a text-book look. 2. Make purposeful and effective use of color. 3. Make effective use of pictures and diagrams. 4. Include a help-line number. 5.    Use a single language.
  • 13. How to enhance findability 1. Organize information hierarchically. 2. Denote importance by using contrast, color, shading, emboldening etc. 3. Provide a key word index using the terminology of the user. 4. Provide a glossary of technical terms. 5. Include a (genuinely useful) trouble-shooting section. 6.    Clearly display the help-line number.
  • 14. What is Technical Description ? • Technical Description is the process of defining or describing a technical object, concept, or process to someone who has little knowledge or experience . • We all use the word description loosely to refer to practically any discussion or explanation. But in this context, it means ”the detailed discussion of the physical aspects of a thing”.
  • 15. When Technical Description should take place ? • Technical descriptions are used – o Before products and processes are developed (as part of proposals and planning documents). o During development (in progress reports, for instance. o Afterwards (as part of marketing and promotional literature and technical support documents).
  • 16. Types of Technical Description - Technical Description is of two types- I.Product Description. II.Process Description.
  • 17. Product Description • A product description explains the features of a specific device, like a scientific instrument or computer program. Possible topics include devices that are specific to your field, or devices you use in everyday life. Example How to use different modules of a computer program.
  • 18. Example Of Product Description for Lenovo Y560 Laptop • Genuine Windows 7 Home Premium • 15.6 inch HD LED Backlit display″ • Intel Core i7/i5/i3 Processor • ATI Radeon HD 5730 1GB Dedicated Graphics • up to 8GB DDR3 RAM • up to 500GB (7200RPM) Hard Disk • Blu Ray Optical Drive • Intel WiMax 6250/6200 a/g/n Wi-Fi • Bluetooth • 6-in-1 Memory Card Reder • 1.3MP Webcam • 3xUSB 2.0, HDMI Connector • 6 cell Li-ion Battery • Weight: 2.7 Kg
  • 19.
  • 20. Process Description • A process description explains how a complex event occurs, including a mechanical process. You can choose a process that is specific to your field, or one that people may be curious about: • i.e. how modules are developed, strategy used, algorithms etc.
  • 21.
  • 22. Example Of Process Description • Tasks. • Input. • Desired Output. • Personnel Involved.
  • 23. How To Write ? • Overview of Item o Definition of the object— identification and function. o Identification of major parts.
  • 24. Contd.. • Description and Function of Parts (repeated as necessary for multiple parts) 1. Definition—identification and function 2. Composition—shape, dimensions, and materials 3. Subparts 4. Relationship to and method of attachment to adjacent parts
  • 25. Contd.. • Operation of Item 1. Summary of parts if necessary. 2. Explanation of one “cycle of operation”. • Maintenance Of Item 1. Simple care steps. 2. What to do and what don’t. 3. Simple steps of precautions.
  • 26. Contd.. • Operational Environment 1. Things needed for that product. 2. Operational Temperature, humidity etc..
  • 27. Refrence • www.wikipedia.com • www.wikianswer.com • www.getsupport.com • www.supportforu.com