Masterspec
01 Apr 2025
Document Referencing and Scheduling with eCert
Our editor team has updated all Masterspec work sections which have references to environmental documents. Where environmental document references...
27 Mar 2025
Update Manager New Features
The new Update Manager features are designed to boost productivity when applying changes to updated work sections. Simplify work section updates with...
03 Mar 2025
CIL is Now Accepting Product Carbon Data for the National Embodied Carbon Data Repository for Construction.
CIL Masterspec is now accepting carbon information in the form of Environmental Product Declarations (EPDs) or Life Cycle Assessments (LCAs) from...
06 Jan 2025
Carbon 2025 and Beyond: Building a More Sustainable Future for NZ Construction
In July 2024, Construction Information Ltd (CIL) and the Building Research Association of New Zealand (BRANZ) announced a partnership to develop a...
01 Nov 2024
Introducing eCert: A Game-Changing Tool for Sustainable Construction
As the New Zealand construction industry increasingly focuses on sustainability and carbon reduction, there is a growing need for tools that can help...
26 Sep 2024
Masterspec Specified: Manawa House by Cube Architecture
"Masterspec has been an indispensable tool for our project Manawa House. During the specification, Masterspec streamlined our entire specification...
26 Sep 2024
Masterspec Specified: Award Winning Ligar Bay Bach by Young Architects
"Masterspec was used for providing a detailed, fully customised, specification as part of our comprehensive project documentation for the Ligar Bay...
25 Sep 2024
Masterspec Specified: Hilltop Home by Jon McAlpine Architecture
“Masterspec is a critical component in our studio. Its user-friendly platform and regular product specification updates, keep us constantly on the...
06 Aug 2024
NZ Building Code Changes: Type 1 Domestic Smoke Alarms
In Masterspec NOTES June 2024, we provided commentary around the changes to the NZ Building Code relating to domestic smoke alarms.
18 Jul 2024
New Industry Initiative to Reduce Carbon Emissions of New Zealand Buildings
A new industry-led initiative aims to reduce the environmental impact of Aotearoa New Zealand’s buildings, which contribute up to 20% of the national...
04 Jul 2024
Masterspec Announces New MasterKey4 for Revit 2025 Enhancements
Streamlined Workflows and Improved Collaboration with MasterKey4. We are excited to announce the latest update to MasterKey4 for Revit 2025, designed...
04 Jun 2024
Building Code Updates 2023-2024
This month we have published amendments in response to building code updates. The 2023-24 NZBC changes were published by MBIE on the 2 November 2023,...
04 Jun 2024
NZ Building Code Changes: Type 1 Domestic Smoke Alarms
From November 2023 the Building Code Acceptable Solutions for Protection from Fire (C/AS1 and C/AS2) have been amended to make Type 1 interconnected...
05 Apr 2024
Understanding Project Scope and How to Specify Window Systems
It is vital that Movement and Deflection criteria are correctly defined in the Specification. We cannot over emphasize the importance of correctly...
04 Apr 2024
MBIE Building Consent System Review - Overview and Update
In July 2022, MBIE commenced a review of the building consent system, as part of the Building System Reforms to improve the consenting process. The...
30 Nov 2023
NZCIC Guidelines Responsibility Schedule Goes Digital
The new online tool enables real-time collaboration among multiple stakeholders, fostering efficiency and innovation in construction processes.
10 Nov 2023
BCA Requests to Modify Manufacturers Technical Content
mDocs allows the specifier to quickly access the latest version of a document uploaded by the manufacturer or supplier. Importantly, these detailed...
27 Sep 2023
Masterspec Specified: Award Winning Taharoto Lane by X Studio Architects
The development will have 19 units, including studio, office, and retail space. The residential units will have balconies with views of the city...
27 Sep 2023
Masterspec Specified: Award Winning Soaring Box House by Turner Road Architecture
The house’s unique design fits into the rural landscape. The house has a cantilevered structure and a soaring angular volume. The interior design is...
13 Sep 2023
Hallmark Group Opens Up About BPIR
Recently, Hallmark Group turned to Masterspec, a trusted name in compliance solutions, for guidance on their BPIR for fire doors. In this article, we...

SPECIFICATION WRITING STYLE - GETTING THE BASICS RIGHT!

21 Jun 2018

Writing style is the cornerstone of readability, ensuring text is relevant and capable of being clearly understood by its intended readership. Style includes a good but not pedantic approach to grammar, simple sentence structure and correct punctuation. Style also means following the sometimes neglected rules of specification writing:

Clarity   Accuracy   Repetition   Brevity   Logic

CLARITY means using plain English, avoiding legalese and jargon and restricting vocabulary to words in common usage. Avoid using alternatives (like excavate for dig) just to make the text more interesting. Nevertheless words should be selected to ensure that their meaning is clear and unambiguous, while phrasing should be brief and expressed in the imperative mood. Use Provide light fittings….’ not ‘The contractor shall provide light fittings…’

ACCURACY Ensure consistency and accuracy by using the same simple terms throughout (‘use,’ ‘supply,’ ‘submit’) and employ accurate and consistent phraseology for repeated clauses. Avoid generalisations, or unclear words or phrasing. Avoid acronyms and abbreviations, unless very well known and incapable of simple error. Blanket clauses implying responsibility for the general or the unknown, must be avoided.

Don’t use gender-specific words and phrases. And avoid nominating specific control functions to particular persons (say architect, engineer, surveyor) unless this is intended. In particular avoid words such as ‘approve’ or ‘approved’ unless this is an essential requirement of the contract.

Avoid redundant and misleading paragraphs; in particular poorly or loosely worded SCOPE clauses at the start of specification sections. SCOPE clauses are legally dangerous as they could be taken by a contractor or subcontractor as encapsulating everything that is required. They are best avoided altogether. At the most they should be restricted to a simple extension of the section title.

Also avoid clauses such as ‘read the General section with this section,’ which might imply that the specification can be broken up into individual parts – a dangerous process contractually.

And don’t repeat general instructions to the contractor in every section unless there is a particular concern (such as the prevalence for some workers to leave debris on site, or a specific risk of damage to adjoining work or finished work).

Avoid listing overly specific, or indefinable requirements such as ‘best trade practice,’ ‘first class work,’ or ‘acceptable standard.’ Only require ‘approval’ or ‘inspection by….’ where this fulfils some specific purpose.

Carefully check secondary consultants’ and specialists’ specification sections to ensure consistency of meaning. Some consultants can include indefinite phrases like ‘builders work,’ or include contractual issues, or even monetary amounts in amongst the technical data. 

REPETITION Documents are meant to be complimentary. The principles to follow are:

  • say everything, but say it only once. Repetition is inadvisable and legally dangerous
  • avoid erroneous information (such as listing a standard that is not referenced in the text) just in case
  • if something applies, include it once. If something does not apply, remove it or leave it out
  • if information is on the drawings, don’t repeat it in the specification, unless the subject requires amplification
  • if an issue is covered in the conditions of contract, don’t repeat it in the specification.

Matters of contract and/or tender must not be included within the technical text.

BREVITY You would not include irrelevant details on drawings and similarly there is no justification for including irrelevant clauses or redundant words in the specification.

LOGIC The Masterspec sections are set in an easily recognisable pattern, with logical and meaningful clause titles and a logical numbering system for all clauses. Cross-referencing within the specification is kept to a minimum, because of possible future changes or project-based modifications. Where unavoidable, clause names rather than numbers are used for cross referencing.

Keep matters of contract, tender and administration separate from the technical sections of the specification, except for specific instructions on quality, or for instructing/informing others (such as a sub-contractor), for example:

  • The obtaining of samples, tests and certification
  • The setting of standards of performance
  • Requirements to provide guarantees, warranties, as-builts, or maintenance information.

This approach allows the technical sections to be more readily used with any chosen method of pricing, administration or contract. It also adds certainty for the contractor and/or project manager when attempting to locate all relevant contract, pricing or administrative requirements.

Don’t specify for failure, such as specifying repairs following damage. That is for the conditions of contract to resolve.

Finally don’t address individual matters to ‘the contractor’ - the whole document is addressed to that one person or entity. 

 

Share this article with your friends 

share linkedin
    share twitter   share facebook

Follow us on Instagram