Upload
stc-atlanta-chapter
View
3.233
Download
3
Tags:
Embed Size (px)
Citation preview
Implementing ISO/IEC 26514 in your workplace
(And why should technical communicators care about standards, anyway?)
George HayhoeMercer University School of Engineering
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?
How are ISO/IEC standards developed?
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
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
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
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)
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.
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)
What standards are relevant to technical communicators in industry and in academe?
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)
What information does ISO/IEC 26514 contain?
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)
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)
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).
What do we mean by conformance to ISO/IEC 26514 requirements?
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
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.
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.
What are the benefits of implementing ISO 26514?
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
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.
Your turn
Questions? Comments? Experience with this or other
standards?