Technical Advisory For Developing Specification
Technical Advisory For Developing Specification
Technical Advisory For Developing Specification
Specification
Basic Specification Writing Principles ("Five C’s" of Good Specification Writing)
To effectively communicate requirements, specifications must be clear, concise, complete,
correct, and consistent. Some general guidance to ensure that a specification meets these "five
C's" of good specification writing is provided below.
1. Clear
a. Specifications are a tool to communicate an owner's expectations regarding the
performance of the work to the contractor. Specifications need to be understood by the
contractor's employees who will be doing the work. The purpose and effect of the
specification should be clear from its language, and the language should convey only one
meaning. To prevent possible ambiguities, conflicts, and confusion in words and sentence
construction, consider the following:
1. Are roles and responsibilities clearly established? The specifications should clearly
indicate the responsibility and authority of both the contractor and the State DOT.
Proper use of active voice and imperative mood, as described in Attachment 5, can
clarify responsibility. Otherwise, the traditional use of shall and will can also identify
responsibility, with shall identifying contractor requirements and will identifying
responsibilities of the State DOT or its representative.
7. Are requirements expressed using plain and well understood terminology? Words
should be used in their true dictionary or technical meaning to avoid conflicts with
ordinary or accepted usage. Colloquialisms and slang expressions should be removed
from specifications. If a good technical word will clearly describe the idea to the
contractor, it should be used exclusively. Specifications should not use synonyms for
literary effect. For example, use "excavate" instead of "cut" or "dig" or "bulldoze."
8. Does the specification include "escape clauses"? Inclusion of phrases such as "as
directed by the engineer," "to the satisfaction of the engineer," or "satisfactory to the
engineer," should be limited, as such language does not convey a measurable standard.
This type of phrase may be used sparingly, such as in unit price items where action
taken by the engineer will not involve changes in cost to the contractor.
11. Do pronouns clearly refer to a specific noun? If a pronoun could refer to more than
one person or object in a sentence, repeat the name of the person or object instead of
using the pronoun, or rewrite the sentence to add clarity.
13. Are modifiers misplaced? Place words carefully to avoid ambiguity. Keep subjects
and objects close to their verbs. Place conditionals such as "only" or "always" and other
modifiers next to the words they modify. For example, write "you are required to
provide only the following," not "you are only required to provide the following."
14. Has all repetition been removed? Requirements should only be stated once to avoid
the possibility of conflicts.
b. Visually appealing documents are easier to understand than traditional blocks of text and
help improve overall clarity. Replacing blocks of text with headings, tables, and white
space will help create a clear and uncrowded presentation, in which main points are
readily apparent and related items are grouped together. Techniques to improve visual
appeal include the following:
1. Headings. Headings break up information into logical, understandable pieces,
which can assist the reader in locating information. Headings should be used
consistently (i.e., all paragraphs at the same level within a particular subpart should
either use or not use headings). The heading should have enough information to
convey the main point of the paragraph, without being so long as to overwhelm the
material in the paragraph itself.
3. Vertical Lists. Vertical lists are a useful technique to present multiple items,
conditions, and exceptions that readers would otherwise have difficulty absorbing in
a block of text. Lists can be used to highlight levels of importance, identify the
necessary steps in a process, and clarify the sequential order of steps in a process.
However, be sure that the list explicitly conveys whether one, more than one, or all
of the list items apply. This can be accomplished by introducing the list with a lead-
in sentence. For example,
a. To indicate an OR situation, the list could be introduced with "…one of the
following:"
b. To indicate an AND/OR situation, one of the following could be used:
"one or both of the following:" when one or two items apply in a list of two.
"one or more of the following:" when more than one item can apply
individually. "one or a combination of the following:" when items can be
combined.
c. To indicate an AND situation, the lead-in "…all of the following:" would
indicate that all items apply.
b. Short sentences that break up information into smaller, easier-to-process units are
better for conveying complex information. Long, complicated sentences filled 56
with dependent clauses and exceptions can confuse readers and obscure the main
point. When reviewing specifications, see if complex sentences can be broken
down into lists or individual sentences.
c. Eliminate or replace wordy phrases and adjectives and adverbs that do not add to
the meaning of the specification.
3. Complete
1. Specifications should provide the information necessary to enable a bidder to
prepare a complete and responsible bid and to enable the contractor to
construct the project properly.
2. Specifications should be complete and should complement and substantiate
the applicable typical sections, dimensions, and details shown on the plans.
3. Omissions, ambiguities, or inconsistencies in the plans or specifications are
not the responsibility of the contractor.
4. Correct
1. Specifications should be accurate and factual. Sources of data used in the
specification should be reliable and current. Careless statements or statements
based on unreliable data are frequently the cause of contract administration
problems and contractor claims. Legalistic words and phrases may shorten or
clarify specifications, but ensure that usage is correct and that alternate
interpretations cannot contradict the intended meaning.
2. To ensure specifications are technically correct, research the topic area
thoroughly and consult subject matter experts as necessary.
5. Consistent
a. Consistency in language selection, usage, format, and organization will help prevent
conflicts and ambiguities in specifications.
b. In addition to the need for consistency in writing specifications, specifications must
also be consistently enforced. Without consistent enforcement, even a well-written
specification becomes ineffective.