Cancellation Notice for Department of Energy Standard 1029-1992, Writer's Guide for Technical Procedures
Document text
Text extracted from the attached file. Refer to the original document for the authoritative version.
Section 1
Department of Energy
Washington, DC 20585
December 8, 2014
MEMORANDUM FOR JEFFREY D. FElT
PROGRAM MANAGER
FROM:
SUBJECT:
TECHNICAL STANDARDS PROGRAM
OFFICE OF NUCLEAR SAFETY
OFFICE OF ENVIRONMENT, HEALTH, SAFETY AND
SECURITY
JAMES B. O'BRIEN Il/¥l-------'
g~~~l~~ NUCLEA()~FETY
OFFICE OF ENVIRON . T HEALTH, SAFETY AND
SECURITY
Cancellation Notice for Depat1ment of Energy
Standard 1029-1992, Writer '8 Guide for Technical Procedul'es
The Department of Energy (DOE) Office of Nuclear Safety recommends the cancellation
and archiving of the DOE Standard (STD) 1029-1992, Writer's Guidefor Technical
Procedures, and submits this proposal for a 60-day review and comment period in
accordance with Section 4.4 of Teclmical Standards Program Procedures 7-2013,
Maintaining DOE Technical Standardr.
Based on discussions with DOE field element pel'sOlmel and contractors, the Office of
Nuclear Safety concluded that the purpose ofDOE-STD-1 029-1992 is adequately
fulfilled by the Procedure Professionals Association (PPA) voluntary consensus standards
PPA AP-907-005 Rev I, September 2011, Procedure Writers' Manual, and PPA-907-
00 I Revision I, September 2011, Procedure Process Description, available at:
http://www.ppaweb.orgldocumentsIPPA-AP-907-005.pdf. These consensus standards
were developed with DOE pat1icipation, and several field elements cut1'ently use them.
In accordance with DOE Order 252.IA, Technical Standards Program, Public Law
104-113, National Technology Transfer and Advancement act of 1995, and the Office of
Management and Budget Circular A-119, Federal Participation in the Development and
Use of Voluntary Consensus Standards and in Conformity Assessment Activities, the
Department is required to use volttntary consensus standards to the maximum extent
possible in the conduct of its activities. DOE-STD-1029-1992 is not invoked as a
requirement in any DOE directives, and if cancelled it will be archived and remain
available on the Technical Standards Program Website. A crosswalk of content in DOE
STD-I 029-1992 to the PP A Standards is attached.
The point of contact for this document is Earl Hughes, O.fflce of Nucleal' Facility Safety
Programs. MI'. Hughes can be reach at (202) 586-0065, or bye-mail at
earLhughes@hg.doe.gov.
Attachment ® Pnllkd \Vllh YJ.,/ inx 0;\ recycled p~p:r
DOE STD 1029 PPA AP-907-005
INTRODUCTION
A primary objective of operations conducted in the U.S. Department of
Energy (DOE) complex is safety. Procedures are a critical element of
maintaining a safety envelope to ensure safe facility operation.
This DOE Writer's Guide for Technical Procedures addresses the
content, format, and style of technical procedures that prescribe
production, operation of equipment and facilities, and maintenance
activities.
Forward (Similar in context)
Organization of this Guide
This guide for writing technical procedures is presented in five sections.
Table of Contents (Similar
1.2 Purpose of this Guide
This writer's guide establishes the recommended process for developing
technical procedures that are accurate, complete, clear and consistent. It
provides guidance for
Developing a procedure basis
Planning, organizing, and structuring
Developing content and establishing format
Writing action steps.
1.0 Purpose and Scope (Similar)
This standard (PPA AP-907-005, Procedure Writer’s
Manual, should be used in conjunction with PPA AP-907-
001, Procedure Process Description.
1.4 Involvement of Operational Organizations in Procedure
Section 2
Development
Procedures are written for facility operational personnel; therefore,
operators are an important source of information when developing
procedures. Personnel from the operational organization should be
involved in the process from the initial decision to write a procedure
through the review, verification, and validation of the procedure.
Implicit, PPA AP-907-001, “Procedure Owner” and
Subject Matter Experts to be involved in the process from
the initial decision to write a procedure through the review,
verification, and validation of the procedure.
DOE STD 1029 PPA AP-907-005
2.0 ESTABLISHING THE BASES FOR PROCEDURES
Because procedures are a critical element of maintaining a safety
envelope, they must be based on the same facility design bases, design
verification and functional test results, safety analyses, and operating
limits and surveillance requirements used to establish the safety
envelope. There are at least three pertinent bases to consider for the
development of the technical procedure, the management control basis,
technical basis, and design basis.
2.1 Research and Planning Process
2.2 Procedure Requirements
2.3 Facility Configuration
2.4 Process Analysis
2.5 Develop the Process and Activities
2.6 Assemble the Results of the Research into the Procedure Basis
2.7 Prepare a Revision History
Technical Basis reviews are covered by the required 10
CFR 50.59 and 10 CFR 72.48 reviews specified in Section
4.4.1 of AP-907-001.
PPA AP-907-001 Section 4.3 and Attachment 1 address
sections 2.1 through 2.6.
2.7 Revision History (Alteration Package) is addressed in
AP-907-001 Definitions and Sections 4.5.1 and 4.7.1.2.
3.0 Content and Format
3.1 General Content and Format Guidelines
This section discusses the technical subject matter content and
organization of a procedure. It also defines the format of procedure
pages, headers, and other elements. All types of procedures are not
within the scope of this writer's guide. While sections within this
writer's guide may apply to other than technical procedures, writers
should exercise discretion when applying the guidance presented.
4.1 General (Similar)
4.2 Procedure Designation (Not addressed in 1029)
DOE STD 1029 PPA AP-907-005
3.1.1 Appropriate Level of Detail
Writing at the appropriate level of detail is the key to successful
communication with procedure users. For ease of use and to reduce
distraction and confusion, only include information in the procedure that
relates directly to completing the task.
[1] Write procedures to a level of detail consistent with the
qualifications and training of the expected users. Job task analyses and
training records provide information useful in assessing the level of
detail requirements. When in doubt, write to the lowest common
denominator.
[2] Provide a level of detail that takes into account the following
variables:
[3] Determine whether the amount and kind of information provided are
adequate for intended users by answering the following questions:
[4] Ensure that the decision making required in the procedure is
consistent with the user's qualifications and level of authority. This
approach permits tasks to be performed with minimum supervision.
[5] Exclude information that is useful only to reviewers or other persons
not involved in performing the procedure.
Addressed in PPA AP-907-005 Section 4.28 and PPA
AP-907-001, Section 4.3.5.
3.1.2 Consistency
Section 3
One of the most important principles in writing effective technical
procedures is to maintain consistency in procedure style, format, and
organization, both within and among procedures. Inconsistencies can
result in users attributing differences in meaning to spurious differences
in presentation. Consistency allows users to move through documents
without having to waste effort interpreting the style of presentation for
each section they encounter.
Addressed in PPA AP-907-005 Section 4.29 and PPA
AP-907-001 Section 4.3.6.
3.1.3 Writing Style and Language
Narrative prose and paragraph style are inappropriate for writing
procedures. Users of procedures will likely be working under difficult,
sometimes very stressful conditions, and thus procedures should be
written so that users can grasp the intended meaning quickly and easily.
Addressed in Section 4.22 – 4.33.
DOE STD 1029 PPA AP-907-005
3.1.4 Numerical Information
[1] Maintain consistency in using Arabic numbers (e.g., 0, 1, 2) and
spelled-out numbers (e.g., zero, one, two).
[2] Use spelled-out numbers when one number without a specified unit
of measure is followed directly by one with a unit of measure.
Addressed in Section 4.27.1.
3.1.5 Instrumentation/Component Information
[1] Refer to instruments and components using both the equipment
name and number. The equipment name can be the verbatim equipment
label, a paraphrased equipment label or some other name, depending
upon which is the most familiar to users. Ideally, there should only be
one name in use for any given piece of equipment. Set the numeric
identifier apart from the equipment name (e.g., by placing it in braces
after the common usage name as in: "Open both Vessel Vent valves
{GH-32-1 and GH-32-2}.").
[2] Do not require users to interpret ambiguous descriptors, such as
"approximately" and "slowly" when referring to instrument information.
[3] Specify numbers in procedures at the same precision and the same
units of measure that they are presented on instrument panel displays.
[4] Express consecutive acceptable values as a range of values rather
than in terms of tolerance bands. Tolerance bands require additional
mental calculation on the part of the users, increasing the probability of
error.
Addressed in Section 4.33 (step 4.33.3a)
3.1.6 Typeface
The readability of type is affected by its font (typeface, point size, and
weight), and case (capitalized versus uncapitalized).
[1] Select typeface font and size so that it is readable under the worst
conditions anticipated. Ensure that the type size is large enough for
users to read at anticipated distances and lighting conditions.
[2] Use a mixture of both upper and lower case in text. Only use capital
letters for emphasis of single words or phrases, not for an entire block of
text.
Addressed in Section 4.4.
DOE STD 1029 PPA AP-907-005
3.1.7 Page Headers and Page Numbering
Each page of the procedure should include a main page header that fits
at the top of the page and clearly distinguishes a specific identity for
each procedure. The identity of a procedure should include a unique
number and the unit (building or system) to which it applies.
Addressed in Sections 4.5 and 4.6.
3.1.8 Procedure Titles
[1] Write procedure titles that are concise, clear, and descriptive of the
system, equipment, process, or activity.
[2] Write procedure titles that are short and descriptive enough to permit
Section 4
the user to easily identify the procedure and activity to which the
procedure applies.
[3] Write unique procedure titles to assist the user in identifying the
correct procedure.
Not Addressed
3.1.9 Headings
Headings break the text of the procedure into sections by grouping
related action steps. Section headings help users locate information in
the procedure, break up long series of actions into manageable chunks,
and track their progress through the procedure, especially when
branching to other sections.
Addressed in Section 4.9
3.1.10 Action Step Numbering
Action steps reduce a task or activity to a discrete set of instructions.
Action step numbering identifies individual action steps and their
sequence.
Addressed in Section 4.9.
3.2 Procedure Organization
A technical procedure is organized to provide the procedure user with
all the needed information to accomplish an activity.
Addressed in Sections 4.11 and 4.13.
3.2.1 Coversheet
The coversheet provides a means for the user to verify that the
procedure is appropriate for the task at hand.
Addressed in Section 4.11.
DOE STD 1029 PPA AP-907-005
3.2.2 Revision Status
It is essential that users follow the most current version of a procedure.
Document control systems typically ensure the most recent versions are
available. Ensure the latest revision is used by including the revision
number on each page of the procedure. Draw the user's attention to
changes (additions, corrections, or deletions) made in the procedure. A
clear, simple means of marking these changes is required.
Addressed in Section 4.13.12.
3.2.3 Table of Contents
The table of contents helps users locate the portions of the procedure
they need for a specific operation and is useful for locating appendixes.
A table of contents is recommended.
Addressed in Section 4.12.
3.3 Introduction
The introduction should address the purpose, scope, and applicability of
the procedure.
Addressed in Section 4.13.
3.4 Precautions and Limitations
Failure to include precautions and limitations within the procedure can
cause a severe injury to, or the death of, the procedure user and/or
serious damage to equipment. The precautions and limitations section
delineates precautions that affect the entire procedure or that occur at
more than one point in the procedure.
Addressed in 4.13.7.
3.5 Prerequisite Actions
The prerequisite actions section identifies actions that must be
completed by the user and requirements that must be met and signed off
before the user continues with the procedure.
Addressed in 4.13.8.
3.5.1 Planning and Coordination
The planning and coordination section includes information on activities
that must be undertaken to plan and coordinate the performance of the
procedure.
Not Addressed (This is addressed in ConOps)
DOE STD 1029 PPA AP-907-005
3.5.2 Performance Documents
Direct the user to obtain all other documents required to perform the
procedure, such as drawings, approved vendor manuals, and other
procedures that may be referenced in the base procedure. Listing these
references in the prerequisite actions subsection ensures that the
documents are available at the job site when needed. Where feasible,
however, include such material in the base procedure to lessen the
number of references the user must refer to.
Addressed in Section 4.13.4.
3.5.3 Special Tools and Equipment, Parts, and Supplies
List special tools, measuring and test equipment, parts, and supplies
Section 5
required to perform the procedure. Strict attention to the completeness
and correctness of this section is extremely important. For example,
failure to specify a necessary item could result in costly equipment
downtime or using a substitute for a specialized tool could damage
equipment. It may be appropriate to provide some of this information in
tables. Lists of material may be more appropriately placed in an
appendix than in this subsection.
Addressed in Section 4.13.8.
3.5.4 Field Preparations
Provide instructions for preparatory field activities that must be
completed before continuing with the procedure.
Mentioned but no specific guidance (4.13.8).
3.5.5 Approvals and Notifications
The approvals and notifications section identifies approvals and
notifications that must occur before the actions in the procedure begin.
Approvals and notifications related to specific action steps in the
procedure are placed adjacent to the affected action step.
Mentioned but no specific guidance (4.13.8).
3.5.6 Terms, Definitions, Acronyms, and Abbreviations
Avoid using a separate section devoted to terms, definitions, and
acronyms in technical procedures. Users should be adequately trained
and familiar with the terms used in the procedure. Facility-specific
glossaries of terms, definitions, acronyms, and abbreviations should be
maintained to ensure consistent use of these elements and consistent
interpretation by the user.
Addresses Definitions in Section 4.13.5 and Acronyms
and Abbreviations are in Section 4.22.
DOE STD 1029 PPA AP-907-005
3.5.7 Responsibilities
In technical procedures, responsibilities are implicit in the action
statements (see Section 4 of this guide for information about writing
action statements). Only action steps that involve personnel in addition
to the user need specify the person responsible for a specific action.
Therefore, because the procedure has a limited number of users, a
separate responsibilities section is not warranted.
Addressed in Section 4.13.6.
3.6 Performance Sections
The performance sections contain the action steps that prescribe the
principal tasks and subtasks of the procedure.
Addressed in Section 4.13.9.
3.7 Post-performance Activity
The post-performance activity section stipulates actions needed to close
out the activity including testing, restoration, and compiling results.
Addressed in Section 4.13.9 and 4.13.10.
3.7.1 Testing
If operability of equipment has been affected while performing a
procedure and operability has to be verified before returning the
equipment to service, include action steps that specify these tests.
Addressed in Section 4.13.10 (vaguely).
3.7.2 Restoration
Provide action steps to specify and record the return of all affected
structures, systems, or equipment to the desired configuration.
Addressed in Section 4.13.9 (vaguely).
3.7.3 Results
Provide instructions to summarize the results of the procedure
Addressed in Section 4.13.10 (vaguely).
3.8 Records
Records generated by a procedure are maintained to document the tasks
completed by performing the procedure. Administrative controls
establish requirements for, and control of, records. Post-task analyses of
the procedure require that the conditions of performance and the
personnel involved are clearly recorded so lessons can be learned if
adverse consequences occur.
Addressed in Section 4.13.11.
DOE STD 1029 PPA AP-907-005
3.9 Source Requirements
Section 6
Source requirements are requirements implemented by the procedure.
There should be a cross-reference between these requirements and the
parts of the procedure which implement them. Source requirements are
identified in this way to alert users who are making an expedited
procedure change.
Addressed in Section 4.19.
3.10 Appendixes
Provide appendixes when the material and function of the procedure
require them. Appendixes are part of the procedure; number pages to
show they are a continuation of the main body of the procedures. In
addition, number appendixes independently to ensure all pages are
available if the appendix is detached from the main body of the
procedure. Examples of items that may be placed in an appendix are
forms, tables, figures, graphs, and some checklists that are too large to
incorporate in the sequence of action steps.
Addressed in Section 4.14.
4 WRITING ACTION STEPS
The basic element of an action step is an imperative sentence— a
command to perform a specific action. An action step answers the
question “what is to be done?” Additional elements, such as cautions
and condition statements, add precision to instructions.
Addressed in Section 4.31.
4.1 Writing Basic Action Steps Addressed in Section 4.31.
4.2 Conditional Action Steps
Conditional action steps are used when a decision is based upon the
occurrence of a condition or a combination of conditions. The use of
conditional action steps is extremely important in technical procedures
as they structure the decisions required by the operator.
Addressed in Section 4.16.
4.3 Non-sequential Action Steps
Procedure users should perform the action steps in the order they are
written unless they are specifically directed to perform action steps in
another order.
Addressed in Section 4.10.3.
DOE STD 1029 PPA AP-907-005
4.4 Equally Acceptable Alternative Action Steps
Equally acceptable alternative action steps are used when it is beneficial
for users to be provided with more than one option. It is important to
ensure that only one alternative is performed.
Addressed in Section 4.16.7.
4.5 Time-dependent Action Steps
Some action steps contain actions that impose time requirements on the
user by specifying the duration of actions or actions that must be
completed within a specific period of time.
Addressed in Section 4.15.6.
4.6 Concurrent Action Steps
Concurrent action steps contain actions that must be performed at the
same time. For example, parameters may have to be monitored or
checked while the user accomplishes another action, or two performers
in different locations may have to execute actions simultaneously.
Addressed in Section 4.16.7.
4.7 Continuous Action Steps
Continuous action steps are conditional action steps where the
conditions they describe must be monitored throughout a procedure or a
portion of a procedure. For example, a user may need to monitor a
gauge and take a specific action if the gauge, at any point during the
procedure, indicates a reading above or below a specific level.
Not Addressed
4.8 Repeated Action Steps
Repeated action steps are simple action steps that must be performed
more than once during the execution of a procedure.
Addressed in Section 4.17.4.
4.9 Action Steps Containing Verifications, Checks, Notifications,
and Data Recording
Verification action steps assure that a specific activity has occurred or
that a stated condition exists. Manipulation by the user may be required.
Section 7
Check action steps call for a comparison with stated requirements; and
no manipulation by the user occurs. Notification action steps require
reporting when given criteria are met. Data recording action steps assure
that desired data are recorded.
Addressed in Sections 4.17, 4.25 and 4.26.
DOE STD 1029 PPA AP-907-005
4.10 Action Steps with Warnings, Cautions, and Notes
Warnings alert users to potential hazards to personnel. Cautions alert
users to potential hazards to products or equipment. Notes call attention
to important supplemental information.
Addressed in Section 4.15.
4.10.1 Warnings and Cautions
Warnings and cautions attract attention to information that is essential to
safe performance; they usually consist of the conditions, design
limitations, practices, and procedures to be complied with to avoid loss
of life, personal injury, health hazards, or damage to equipment. An
industry study of significant events attributed one-fourth of all human
performance events to a failure to provide proper warnings and cautions.
Addressed in Section 4.15.
4.10.2 Notes
Notes call attention to important supplemental information. The
information can be a reminder of preparatory information needed to
perform the activities of a procedure or action step.
Addressed in Section 4.15.
4.11 Action Steps Directing Users Elsewhere— Branching and
Referencing
To perform a task, sometimes users must branch or reference another
procedure, section, or appendix. Branching routes the procedure user to
other action steps or sections within the procedure or to other
procedures, and the user does not return to the original position.
Referencing routes the procedure user to other action steps or sections
within the procedure or to other procedures and then back to the original
position in the base procedure. Referencing and branching increase the
potential for error with attendant safety and administrative
consequences. Therefore, branching and referencing are highly
discouraged. Use referencing and branching only when it is necessary to
direct the user to information that is vital to the performance of the
activity and it is not appropriate to incorporate that information into the
base procedure.
Addressed in Section 4.30.
DOE STD 1029 PPA AP-907-005
4.12 Action Steps with Acceptance Criteria
Acceptance criteria provide a basis for determining the success or
failure of an activity. Acceptance criteria may be qualitative (specify a
given event that does or does not occur) or quantitative (specify a value
or value range).
Addressed in Section 4.13.10.
4.13 Action Steps with Placekeeping and Sign Offs Addressed in Section 4.17.
4.13.1 Place-keeping
Place-keeping helps users to keep track of their progress in a procedure
and reduces the probability of omitting or duplicating action steps. The
place-keeping mechanism typically consists of check-off boxes.
Addressed in Section 4.17.
4.13.2 Sign Offs
Written responses for action steps that require independent verification,
inspection, data recording, or documentation of completion can also be
placekeeping devices. The use of signatures, initials, check marks, and
“N/A” should be defined in site-specific administrative procedures.
Addressed in Section 4.17.
4.13.3 Sign Off or Check Off of Conditional Action Steps
In some instances, performing an action depends on a condition or
combination of conditions. Conditional action steps are introduced by
Section 8
the words IF or WHEN and are followed by an action.
Addressed in Section 4.16.
Appendix A: Worksheets The intent is captured in Sections 4.25 (Checklists) and
Section 4.26 (Data Collection)
DOE STD 1029 PPA AP-907-005
Appendix B: Example of a Technical Procedure
This appendix contains an example of a technical procedure, "Reservoir
Plug Welding", which has been structured and formatted according to
this guide. The example demonstrates much of the guidance put forward
in this writer's guide and supplements the examples given in the text.
The procedure was adapted from an actual procedure in use at a DOE
facility. The main purpose in adapting this procedure was to illustrate
the structure and formatting guidance, not to demonstrate a technically
perfect procedure. The adapters did not have access to the procedural
basis and so could not verify the technical assumptions implicit in the
adaptation. Parts of the example procedure have been omitted as they
provided no additional exemplary material. These omitted sections have
been identified in the body of the procedure.
Not Addressed, however examples of each procedure
section are included in the body of the procedure.
Appendix C: Glossary Called Definitions in both PPA AP-907-005 and 001.
Most are covered between the two documents although
some terms are not defined the same as in 1029.
Appendix D: Acronyms and Abbreviations PPA AP-907-005 does provide guidance on acronyms in
section 4.22
Appendix E: Action Verb List Addressed in Attachment 1. PPA AP-907-005 Action
Verb List is more extensive.
NOTE: If the column for AP-907-005 just has a section number then it is referring to the 005 document. Where the material in 1029
in covered in AP-907-001 it will state that in the column.