Design documentation
Contents |
[edit] Introduction
Documentation is the process, act or instance of classifying, annotating or authenticating information contained within documents for purposes of factual verification or permanent record keeping. A document is a representation of information in a written, drawn or digital form.
Design documentation is a term that is sometimes associated with the development of computer software (as in architecture design documentation) and web design (as in user experience or UX). In Design Documentation: Why You Need It, Nick Babich provides an overview of the basic ideas of design documentation for UX. This includes:
- Making documentation usable for the target audience.
- Providing up-to-date documentation.
- Working on design documentation incrementally.
- Testing documentation.
- Avoiding jargon.
- Creating easy access.
- Providing visual samples in the documentation.
Generally, this sort of design documentation should include information about users, implementation details, agreed upon decisions and project deadlines. The creation of design documentation should take place during the early stages of a project in order to clarify expectations and expedite the achievement of goals.
[edit] Building design documentation
These same basic principles can apply to design documentation for building and construction. At the very least, there should be a suitable amount of documentation written to inform staff at an appropriate level of the work that they are expected to complete.
Ideally, this collection of documents and resources should cover all design aspects of a building project, including decisions that have been made during the design process to satisfy business, legal, environmental, social, technical and so on requirements and support the execution of the design.
This can include specifications, drawings, operational information, and other relevant documents (explanatory diagrams, tables and charts, standards, surveys and so on).
The amount and depth of the documentation will depend on the requirements of the design brief, and other documentation such as employers information requirements.
There are a number of articles on Designing Buildings describing particular types of documentation and documents:
- Contract documents.
- Tender documentation.
- Types of drawings.
- Briefing documents.
- Specifications.
- Legislation.
- Regulations.
- Planning permission.
- Certificates.
- Permits.
- Approvals.
- BIM.
- Construction contract certificates, notices and instructions.
For more information see: Design process.
[edit] Related articles on Designing Buildings
- Commissioning documentation.
- Document.
- Handover to client.
- Project brief for design and construction.
- Quality management systems (QMS) - beyond the documentation.
- Record keeping.
- User experience UX.
[edit] External resources
- Nick Babich, Design Documentation: Why You Need It.
Featured articles and news
The Architectural Technology podcast: Where it's AT
Catch up for free, subscribe and share with your network.
The Association of Consultant Architects recap
A reintroduction and recap of ACA President; Patrick Inglis' Autumn update.
The Home Energy Model and its wrappers
From SAP to HEM, EPC for MEES and FHS assessment wrappers.
Future Homes Standard Essentials launched
Future Homes Hub launches new campaign to help sector prepare for the implementation of new building standards.
Building Safety recap February, 2026
Our regular run-down of key building safety related events of the month.
Planning reform: draft NPPF and industry responses.
Last chance to comment on proposed changes to the NPPF.
A Regency palace of colour and sensation. Book review.
Delayed, derailed and devalued
How the UK’s planning crisis is undermining British manufacturing.
How much does it cost to build a house?
A brief run down of key considerations from a London based practice.
The need for a National construction careers campaign
Highlighted by CIOB to cut unemployment, reduce skills gap and deliver on housing and infrastructure ambitions.
AI-Driven automation; reducing time, enhancing compliance
Sustainability; not just compliance but rethinking design, material selection, and the supply chains to support them.
Climate Resilience and Adaptation In the Built Environment
New CIOB Technical Information Sheet by Colin Booth, Professor of Smart and Sustainable Infrastructure.
Turning Enquiries into Profitable Construction Projects
Founder of Develop Coaching and author of Building Your Future; Greg Wilkes shares his insights.
IHBC Signpost: Poetry from concrete
Scotland’s fascinating historic concrete and brutalist architecture with the Engine Shed.
Demonstrating that apprenticeships work for business, people and Scotland’s economy.
Scottish parents prioritise construction and apprenticeships
CIOB data released for Scottish Apprenticeship Week shows construction as top potential career path.
From a Green to a White Paper and the proposal of a General Safety Requirement for construction products.
Creativity, conservation and craft at Barley Studio. Book review.
The challenge as PFI agreements come to an end
How construction deals with inherited assets built under long-term contracts.
Skills plan for engineering and building services
Comprehensive industry report highlights persistent skills challenges across the sector.
Choosing the right design team for a D&B Contract
An architect explains the nature and needs of working within this common procurement route.
Statement from the Interim Chief Construction Advisor
Thouria Istephan; Architect and inquiry panel member outlines ongoing work, priorities and next steps.