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
BSRIA Statutory Compliance Inspection Checklist
BG80/2025 now significantly updated to include requirements related to important changes in legislation.
Shortlist for the 2025 Roofscape Design Awards
Talent and innovation showcase announcement from the trussed rafter industry.
OpenUSD possibilities: Look before you leap
Being ready for the OpenUSD solutions set to transform architecture and design.
Global Asbestos Awareness Week 2025
Highlighting the continuing threat to trades persons.
Retrofit of Buildings, a CIOB Technical Publication
Now available in Arabic and Chinese aswell as English.
The context, schemes, standards, roles and relevance of the Building Safety Act.
Retrofit 25 – What's Stopping Us?
Exhibition Opens at The Building Centre.
Types of work to existing buildings
A simple circular economy wiki breakdown with further links.
A threat to the creativity that makes London special.
How can digital twins boost profitability within construction?
The smart construction dashboard, as-built data and site changes forming an accurate digital twin.
Unlocking surplus public defence land and more to speed up the delivery of housing.
The Planning and Infrastructure Bill
An outline of the bill with a mix of reactions on potential impacts from IHBC, CIEEM, CIC, ACE and EIC.
Farnborough College Unveils its Half-house for Sustainable Construction Training.
Spring Statement 2025 with reactions from industry
Confirming previously announced funding, and welfare changes amid adjusted growth forecast.
Scottish Government responds to Grenfell report
As fund for unsafe cladding assessments is launched.
CLC and BSR process map for HRB approvals
One of the initial outputs of their weekly BSR meetings.
Building Safety Levy technical consultation response
Details of the planned levy now due in 2026.
Great British Energy install solar on school and NHS sites
200 schools and 200 NHS sites to get solar systems, as first project of the newly formed government initiative.
600 million for 60,000 more skilled construction workers
Announced by Treasury ahead of the Spring Statement.