implementing iso 26514 in your workplace
TRANSCRIPT
![Page 1: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/1.jpg)
Implementing ISO/IEC 26514 in your workplace
(And why should technical communicators care about standards, anyway?)
George HayhoeMercer University School of Engineering
![Page 2: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/2.jpg)
What will we be talking about today?
How are standards developed? What standards are relevant to
technical communicators in industry and in academe?
What are the requirements for implementing ISO/IEC 26514?
What are the benefits of implementing ISO/IEC 26514?
![Page 3: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/3.jpg)
How are ISO/IEC standards developed?
![Page 4: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/4.jpg)
What is a technical standard? “… [A] formal document that
establishes uniform engineering or technical criteria, methods, processes and practices” (Wikipedia)
Issued by a respected, authoritative entity UL, IEEE NIST, Standards Council of Canada, BSI ISO/IEC
![Page 5: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/5.jpg)
ISOspeak lesson 1
ISO/IEC: International Organization for Standardization/International Electrotechnical Commission
JTC1/SC7: Joint Technical Committee 1, subcommittee 7, responsible for software and systems engineering standards
WG2: Working group 2, responsible for user documentation
![Page 6: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/6.jpg)
What is unique about ISO/IEC standards?
Represent the efforts of experts from a minimum of 5 countries
Iteratively drafted and balloted, with all technical comments resolved
Published by ISO and widely adopted around the world
![Page 7: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/7.jpg)
ISOspeak lesson 2
Editorial comments Technical comments WD: Working draft (not balloted) CD: One or more committee drafts and
ballots FCD: Final committee draft and ballot FDIS: Final draft international standard
and ballot (no technical comments allowed)
![Page 8: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/8.jpg)
Where does the working draft come from?
Existing organizational, national, or international standards
Book and article descriptions of best practices
Working group discussions about best practices
The vast majority of WG members are volunteers.
![Page 9: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/9.jpg)
Schedule for ISO/IEC 26514 Working draft/committee draft written (May
2006) Ballot comments resolved (November 2006) Final committee draft written (December 2006) Ballot comments resolved (May 2007) Final draft international standard written
(October 2007) Ballot comments resolved (May 2008) International standard published (June 2008)
![Page 10: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/10.jpg)
What standards are relevant to technical communicators in industry and in academe?
![Page 11: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/11.jpg)
JTC1/SC7/WG2 suite of standards 26511: Requirements for managers of user
documentation (CD being prepared) 26512: Requirements for acquirers and suppliers
of user documentation (FDIS being prepared) 26513: Requirements for testers and assessors of
user documentation (published 2010) 26514: Requirements for designers and
developers of user documentation (published 2008)
26515: Developing user documentation in an agile environment (CD being prepared)
![Page 12: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/12.jpg)
What information does ISO/IEC 26514 contain?
![Page 13: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/13.jpg)
First it defines the process.
“The first part of this standard covers the user documentation process for designers and developers of documentation. It describes how to establish what information users need, how to determine the way in which that information should be presented to the users, and how to design the information and make it available. It is not limited to the design and development phase of the life cycle, but includes activities throughout the information management and documentation processes.” (p. 1)
![Page 14: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/14.jpg)
Then it defines minimum requirements.
“The second part of this standard provides minimum requirements for the structure, information content, and format of user documentation, including both printed and on-screen documents used in the work environment by users of systems containing software. It applies to printed user manuals, online help, tutorials, and user reference documentation.” (p. 1)
![Page 15: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/15.jpg)
There are no surprises.
Best practices in documentation processes reflect Hackos’s Managing Your Information Projects (1994).
Requirements for usability testing reflect Hackos and Redish’s User and Task Analysis for Interface Design (1998) and Barnum’s Usability Testing and Research (2002).
![Page 16: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/16.jpg)
What do we mean by conformance to ISO/IEC 26514 requirements?
![Page 17: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/17.jpg)
How can your organization claim conformance?
An organization may claim conformance for Its documentation process Its documents Both its process and its documents
The standard is meant to be tailored: To apply to necessary requirements To apply to cost-effective requirements
![Page 18: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/18.jpg)
Conformance situations
You may claim and document conformance For the organization For a project For a multi-supplier program For individual documentation products or
document sets
You may also use the standard as guidance.
![Page 19: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/19.jpg)
ISOspeak lesson 3
Shall indicates a binding provision. Should indicates a recommendation. Change shall to should if you are using
the standard as guidance rather than claiming conformance.
May indicates a permissible course of action.
![Page 20: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/20.jpg)
What are the benefits of implementing ISO 26514?
![Page 21: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/21.jpg)
The standard benefits both industry and academe.
Enhanced credibility and leverage with management
Better prepared graduates Improved hiring and human resources
criteria Greater consistency of products and
processes
![Page 22: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/22.jpg)
Activity
Outline a memo to your boss. Explain significance of ISO/IEC 26514. Describe advantages to your
organizations of adopting the standard.
Suggest an implementation plan.
![Page 23: Implementing ISO 26514 in Your Workplace](https://reader035.vdocuments.us/reader035/viewer/2022081419/5562df52d8b42ad26c8b4654/html5/thumbnails/23.jpg)
Your turn
Questions? Comments? Experience with this or other
standards?