The proper amount of specificity

What is the appropriate level of detail for a specification?


Specifications, by nature, are very specific. However, there is a point at which they can be too detailed and can cause conflicts with other contract documents, such as drawings, Division 01 general requirements, or the general conditions.

While they complement each other, contract documents are not supposed to duplicate information. The motto, "say it once and say it right," should always be in mind when an engineer is putting together design documents.

Contract documents—which include the contract between the owner and contractor, the project manual, and drawings—have a hierarchy, which goes from very general to very specific. At first glance, it appears that the “say it once and say it right” principle is being willfully ignored, but let's take a quick tour through the documents to show that the level of specificity in the contract documents starts broadly and then narrows.

The procurement requirements are occasionally thought of as a part of the contract documents, but they aren't, so we'll begin with the owner-contractor agreement. This agreement is a part of the contract documents and is the basis of any agreement between the owner and the contractor. It also includes all of the other contract documents via incorporation by reference.  This is a purposely broad and nonspecific agreement that defines the relationship between the two parties.

The general conditions of the contract define, in a very broad manner, who does what. This document describes administrative procedures, working hours, warranty conditions and length, payment procedures, retainage, the punch list, and closeout procedures, among other items. Again, the scope of this document is very broad. For instance, there may be a requirement for a 2-year building warranty after the end of the 1-year construction warranty. This document would define the timeframes of the warranties and name the contractor as the party responsible for the warranty. It would also point the contractor to the appropriate specification section to find further details on the expected warranty service.

The first part of the specification, Division 01 general requirements, is similar to the general conditions of the contract in that the items described in Division 01 apply to all of the specification sections and drawings. However, there is significantly more detail in Division 01 than in the general conditions. Using the warranty example, the general requirements would elaborate on what is covered under the warranty, whether products will be replaced or repaired, the response time, and whether a manufacturer's warranty is required, to name a few of the items. Overall, there is a higher level of detail in Division 01 than there is in the general conditions.

Often, the general requirements are very specific to each owner and are edited by either the owner or prime engineer. The general requirements, and any customized specification sections should provided to the engineer to use prior to or during design, as they often have special provisions that have been inserted by the owner. Click here to see the U.S. Dept. if Veterans Affairs’ general requirements and standard specifications.

Note: Master Format, the standard for organizing building system information in the United States contains Division 00 – Procurement and Contracting Requirements, Division 01- general requirements, and Divisions 02 through 48, which are used for work results. MasterFormat 2014 was recently released.

Part 1 in a Division 02 through Division 48 specification section gets even more specific, describing what constitutes a product failure and the length of special or nonstandard warranties. One needs to be especially careful when writing warranty (for a discussion of the difference between a warranty and guarantee, see the discussion here) provisions into an individual specification, as more than one well-meaning engineer has undone the work of the project manager, executive, or lawyer who wrote Division 01 by including conflicting provisions in a Division 02 through Division 48 specification.

Continuing with the warranty example, specifically naming the terms of the warranty in a product specification may actually limit the owner's rights and cause an unwarranted increase in the cost of the product. The American Institute of Architects' standard contract documents include a 1-year correction period in which the contractor is responsible for replacing or repairing any defective work. Requiring the contractor and manufacturer to provide and document a 1-year warranty to the engineer is an additional and unnecessary task, as the 1-year correction period described in Division 01 overrides any warranty provisions.

Also, if someone noticed that the warranty provisions in the Division 02 through Division 48 specification do not complement Division 01 or the general conditions, that person could argue about the true intent of the warranty. It is appropriate, however, to mention specific manufacturers' warranties, such as a 5-year warranty, or certain warranty provisions, such as replacing instead of repairing, within a Division 02 through Division 48 specification.

The proper amount of specificity depends on what you are writing, and where the language is located. Think of it as an inverted pyramid—broad requirements in at the top or in the front end of the project manual with more specific requirements, that are coordinated with the other sections of the project manual, as one gets further down into the project manual.

Michael Heinsdorf, PE, LEED AP, CDT is an Engineering Specification Writer at ARCOMMasterSpec. He has more than 10 years' experience in consulting engineering, and is the lead author of MasterSpec Electrical, Communications, and Electronic Safety and Security guide specifications. He holds a BSEE from Drexel University and is currently pursuing a Masters in Engineering Management, also at Drexel University.

No comments
The Engineers' Choice Awards highlight some of the best new control, instrumentation and automation products as chosen by...
The System Integrator Giants program lists the top 100 system integrators among companies listed in CFE Media's Global System Integrator Database.
Each year, a panel of Control Engineering and Plant Engineering editors and industry expert judges select the System Integrator of the Year Award winners in three categories.
This eGuide illustrates solutions, applications and benefits of machine vision systems.
Learn how to increase device reliability in harsh environments and decrease unplanned system downtime.
This eGuide contains a series of articles and videos that considers theoretical and practical; immediate needs and a look into the future.
Additive manufacturing benefits; HMI and sensor tips; System integrator advice; Innovations from the industry
Robotic safety, collaboration, standards; DCS migration tips; IT/OT convergence; 2017 Control Engineering Salary and Career Survey
Integrated mobility; Artificial intelligence; Predictive motion control; Sensors and control system inputs; Asset Management; Cybersecurity
Featured articles highlight technologies that enable the Industrial Internet of Things, IIoT-related products and strategies to get data more easily to the user.
This article collection contains several articles on how automation and controls are helping human-machine interface (HMI) hardware and software advance.
This digital report will explore several aspects of how IIoT will transform manufacturing in the coming years.

Find and connect with the most suitable service provider for your unique application. Start searching the Global System Integrator Database Now!

Infrastructure for natural gas expansion; Artificial lift methods; Disruptive technology and fugitive gas emissions
Mobility as the means to offshore innovation; Preventing another Deepwater Horizon; ROVs as subsea robots; SCADA and the radio spectrum
Future of oil and gas projects; Reservoir models; The importance of SCADA to oil and gas
Automation Engineer; Wood Group
System Integrator; Cross Integrated Systems Group
Jose S. Vasquez, Jr.
Fire & Life Safety Engineer; Technip USA Inc.
This course focuses on climate analysis, appropriateness of cooling system selection, and combining cooling systems.
This course will help identify and reveal electrical hazards and identify the solutions to implementing and maintaining a safe work environment.
This course explains how maintaining power and communication systems through emergency power-generation systems is critical.
click me