GDS Technology — Built, Wired and Secured podcast banner
Watch on YouTube →
Episodes Built
Episode 157

The Documentation Deficit: When Your Building's History Is Written in Someone's Head

October 16, 2026
Key takeaways
  • Undocumented building knowledge can turn a two-minute fix into hours of discovery and significant emergency cost.
  • Small undocumented changes accumulate until official drawings no longer reflect the building’s actual systems.
  • Start documentation with the critical systems and interdependencies that could bring operations to a halt.
  • Capture access procedures, vendors, emergency contacts, and processes alongside physical diagrams.
  • Use knowledge audits, cross-training, after-action reviews, and vendor requirements to make documentation continuous.

Show Notes

The Knowledge That Lives in Someone’s Head

Every building has an unofficial operating manual. It may not be stored in a shared drive or attached to an as-built drawing. Instead, it lives in the memory of the people who have worked there long enough to know which breaker feeds which panel, which conduit carries the fiber, which valve needs to be turned twice before it seals, or how to reach a room that was never labeled clearly.

In this episode of Built, Wired & Secured, Alex Morgan speaks with James Rogers and Michael Harrington about the documentation deficit: the gap between a building’s documented systems and the way those systems actually exist. Their discussion focuses on what happens when tribal knowledge walks out the door, why small undocumented changes become major operational risks, and how owners and operators can create practical knowledge-transfer habits.

When a Retirement Becomes an Operational Incident

James shares the story of a maintenance manager who had spent 30 years in the same building. When that manager retired on a Friday, a power blip brought down the network the following Monday. The new team could not find the transfer switch because it was not shown on any drawing. Finding it took four hours. Once located, the fix itself required only a two-minute switch throw.

The discovery process created the real cost. Emergency callouts, overtime, and expedited parts added up to about $10,000, before accounting for tenant frustration. The new employee also spent 45 minutes simply trying to find the panel room because the door was not labeled. The problem was not a complex repair. It was missing institutional memory.

The Slow Drift Away From Reality

Large handoffs are not the only risk. Documentation can erode quietly over years. A cable gets rerouted to make room for a new server. A contractor changes a breaker setting to address a nuisance trip. A panel is derated for a new load. None of those changes make it onto the drawings.

Individually, each omission may seem harmless. Collectively, they can make the building’s drawings so inaccurate that they are no longer dependable. Michael describes the property-management reality: the documentation gap may remain invisible until a tenant reports an outage and someone asks for the as-built drawings. “Not exactly current” can mean the response will be based on guesswork.

Undocumented Changes Can Cascade

The guests discuss a panel that had been derated years earlier but never marked. Later, more equipment was added, overloading the panel and causing a trip. The result was a loss of HVAC for an entire floor in the middle of summer. Tenants experienced the consequence directly: an uncomfortable office and a network outage, without needing to know why the failure occurred.

For property managers, the incident creates a second burden. They must explain why what looked like a simple maintenance task became a broader event. Accurate history helps teams respond faster, make safer decisions, and reduce the discovery work that drives emergency costs.

Document the Critical 20 Percent First

James recommends resisting the urge to document everything at once. A complete, immediate documentation project can create burnout and may never get finished. Instead, start with the critical 20 percent: the systems that could bring the building to its knees if they fail.

  • Power systems and the locations of critical switching equipment
  • Network topology and the paths that connect important infrastructure
  • Life safety systems
  • Interdependencies between power, network, HVAC, and other building systems

Michael adds that documentation should cover more than physical equipment. Teams also need to capture access procedures, vendors, emergency contacts, and the process for reaching or operating a system. The “what” matters, but the “how” and “who” can be just as important during an incident.

Make Documentation Part of the Workflow

The most reliable documentation practice is not a massive one-time project. It is a small step built into normal operations. After a significant change, conduct a quick after-action review: What changed? What was learned? Which drawings or records need to be updated?

The review may take about 10 minutes, but it is easy to cut when the team is busy. Vendor contracts can help reinforce the habit. Require contractors to provide updated as-built drawings before they are paid for work that changes the building. The people who made the change are often in the best position to document it accurately.

Capture Knowledge Before It Walks Out

If an experienced employee is retiring or leaving, start a knowledge audit. Walk through the building system by system and ask that person to identify what is not on the drawings. Record the walkthrough when possible. In the example discussed, that process uncovered a secondary waterline that no one else knew existed.

Knowledge transfer should not depend on one person. Shadowing, cross-training, and rotating responsibilities help ensure that no critical system has a single keeper. The goal is to capture existing knowledge while also creating a team that can maintain it.

Three Actions to Take This Week

  • Walk the building with the most experienced person available and conduct a knowledge audit.
  • Choose one critical system and document it thoroughly.
  • Schedule recurring time to review and update the records.

You do not need an elaborate software platform to begin. The guests emphasize that a shared drive with well-named folders is better than doing nothing. Documentation is not paperwork for its own sake. It protects the building’s memory, reduces operational uncertainty, and helps protect the owner’s investment.

Deeper dive

When a Building’s History Exists Only in Someone’s Head

Buildings rarely fail because nobody cares about operations. More often, they become difficult to operate because critical knowledge was never transferred from the people who held it. A facilities manager remembers which breaker feeds a panel. An electrician knows why a setting was changed. An IT lead can trace a network drop to a switch port without opening a diagram. The building works, so the knowledge remains informal.

That arrangement can last for years. Then the experienced employee retires, a contractor leaves, or an urgent incident exposes a gap. Suddenly, the team is not only repairing a problem. It is trying to discover how the building was built, modified, and operated in the first place.

The Cost of Missing History

In a recent Built, Wired & Secured conversation, James Rogers described a maintenance manager with 30 years in the same building. The manager could identify equipment and pathways from memory. After he retired on a Friday, a power blip brought down the network on Monday.

The incoming employee could not find the transfer switch. It was not shown on any drawing. Locating it took four hours, even though the eventual repair required only a two-minute switch throw. The building incurred approximately $10,000 in emergency callouts, overtime, and expedited parts. That figure did not include the frustration experienced by tenants. The new employee also spent 45 minutes looking for the panel room because the door was not labeled.

This is the documentation deficit in practical terms. The building did not necessarily need a sophisticated new system. It needed basic facts to be available to more than one person.

Documentation Erodes One Small Change at a Time

Employee turnover creates an obvious handoff problem, but the slower threat is undocumented change. A cable is rerouted to make space for a server. A contractor modifies a breaker setting after a nuisance trip. A panel is derated for a new load. The work solves an immediate problem, but nobody updates the drawing.

One omission may not create an incident. Ten years of omissions can make the official record unreliable. When a tenant reports an outage and the team asks for current as-built drawings, “we have something, but it is not exactly current” becomes a warning that the response will involve guesswork.

A drawing that no longer reflects the building is more than an administrative inconvenience. It can send technicians down the wrong path, delay restoration, increase emergency labor, and introduce safety concerns. It can also hide dependencies between systems that are normally managed separately.

How a Small Unknown Becomes a Building-Wide Problem

The episode includes an example of a panel that had been derated years earlier. The change was never marked. Later, more equipment was added, overloading the panel and causing it to trip. HVAC service was lost for an entire floor during the summer.

Tenants experienced the result as an 85-degree office and a network outage. They did not need to understand the panel history to feel the impact. The property manager then had to explain why what appeared to be a simple maintenance task had become a larger incident.

That is why documentation should be treated as an operational control, not just a records-management task. Accurate information helps the team understand what changed, where dependencies exist, and which response steps are appropriate before work begins.

Start With the Systems That Matter Most

Trying to document every asset, cable, valve, setting, and procedure at once is likely to overwhelm the team. James recommends starting with the critical 20 percent: the systems that could bring the building to its knees if they fail.

  • Power systems and critical switching equipment
  • Network topology and important connectivity paths
  • Life safety systems
  • Dependencies between power, network, HVAC, and other building systems

This approach creates a practical risk-based starting point. The objective is not to produce a perfect archive before anyone can use it. The objective is to make the most consequential information accurate and accessible first.

Capture the How and the Who

Physical diagrams are important, but they are only part of a usable operating record. Michael Harrington points out that teams also need to know how to access a room, which vendor supports a system, and who to contact during an emergency.

Those details often remain tribal knowledge because they are not viewed as engineering information. In a real incident, however, they can determine whether the team moves quickly or spends hours searching. A useful record should answer three questions: What is the system? How do we reach or operate it? Who can help when the internal team needs support?

Turn Documentation Into a Habit

Documentation usually loses to the urgent task in front of the team. The answer is to attach it to work that is already happening. After a significant change, perform a short after-action review. Record what was done, what was learned, and which drawings or procedures need to be updated.

The review may take only about 10 minutes, but consistency matters more than scale. Vendor agreements can reinforce the process by requiring contractors to submit updated as-built drawings before payment. The people who performed the work are responsible for documenting the result, rather than leaving the property team to reconstruct it later.

Transfer Knowledge Before Departure

When a veteran employee is leaving, conduct a knowledge audit. Walk through the building system by system. Ask the employee to identify equipment, pathways, settings, access requirements, vendor relationships, and exceptions that are not shown on the drawings. Record the walkthrough when possible.

In the example from the episode, a walkthrough uncovered a secondary waterline that no one else knew existed. That discovery illustrates why a structured conversation is valuable: experienced people often carry knowledge they do not realize is missing from the official record.

Knowledge transfer should also be shared across the team. Shadowing, cross-training, and rotating responsibilities reduce the risk that one person becomes the only keeper of a critical process. The goal is not to replace experience. It is to make experience available when the original expert is unavailable.

A Practical First Week

Owners and operators can begin without buying a new platform. This week, walk the building with the most experienced person available and note what is not documented. Select one critical system and document it completely enough for another qualified team member to understand it. Then schedule recurring time to review and update the records.

A shared drive with well-named folders is better than waiting for a perfect software system. The important decision is to establish a dependable place for the information and a clear expectation that changes will be recorded.

Protect the Building’s Memory

Documentation is often described as paperwork, but its real purpose is continuity. It preserves the history behind current conditions, shortens the path from failure to diagnosis, and reduces the cost of rediscovering facts under pressure.

The best day in operations is the day nobody notices. Small documentation habits help keep it that way. To hear the full discussion about building memory, tribal knowledge, and practical knowledge transfer, listen to this episode of Built, Wired & Secured.