Explore the series:
Part 4: Building Government Services People Can Actually Use
By the time Washington D.C.’s Department of Buildings had transformed inspections and permit workflows, its core systems were significantly more efficient. Processes were faster, data was centralized, and users could track progress in real time.
However, another important aspect of service delivery remained unchanged: documentation.
For both internal teams and external users, documentation is essential. It defines requirements, explains processes, and supports every step of compliance. In Washington D.C., this information was primarily delivered through PDFs, which created increasing friction as the system scaled.
While widely used, PDF documents created several challenges. They were difficult to search, navigate, and maintain, especially as the volume of documentation grew. Information was often scattered across multiple files, making it time-consuming for both employees and external users to locate the content they needed.
From an operational perspective, maintaining documentation required significant manual effort. Updates had to be applied across multiple documents without version control or centralized management, increasing the risk of inconsistencies and outdated information. As workflows became more complex, these limitations slowed down internal processes and made it harder for teams to keep documentation aligned with changing requirements.
By moving to lightweight, HTML-based documentation, the Department of Buildings was able to centralize content, introduce full-text search, and simplify navigation. This made it significantly easier for employees to find relevant information quickly, reduced the time required for updates, and improved overall efficiency across the organization.
As digital platforms such as Tertius, Certifi, and Wallcheck expanded, this shift became essential to maintaining a scalable and manageable system.
To address these challenges, the Department of Buildings partnered with platformOS to implement a documentation system based on a Docs as Code approach, using DocsKit.
Documentation was transformed from static PDFs into structured, HTML-based content that could be centrally managed and continuously updated. Instead of maintaining separate documents, content was organized into reusable components, allowing updates to be applied consistently across the system.
The new system introduced centralized content management, version control, and reusable components. As a result, documentation became easier to manage, more reliable, and better aligned with evolving workflows.
These improvements made documentation not only more compliant, but also more usable.
With HTML-based documentation, users could search across all content instantly, rather than manually navigating multiple files. Clear structure and navigation made it easier to understand requirements and find relevant sections quickly.
For internal teams, this reduced the time spent answering repetitive questions and searching for information across documents. For external users, it simplified the process of completing applications and understanding compliance requirements.
These changes improved usability across the board, making documentation a functional part of the system rather than a separate resource.
The shift to a structured documentation system also had a direct impact on operational efficiency.
Content updates that previously required hours could now be completed in minutes, reducing update time by approximately 90%. Centralized management eliminated duplication and ensured that all users accessed the same, up-to-date information.
Because documentation was no longer tied to static files, it could evolve alongside workflows. This made it easier for the Department of Buildings to respond to regulatory changes and maintain consistency across multiple platforms.
In addition, the use of lightweight HTML content reduced data usage and improved system performance, supporting a more efficient and sustainable digital infrastructure.
An important aspect of this transformation is how documentation integrates with the broader digital ecosystem.
Rather than existing separately, documentation is now aligned with platforms such as Tertius, Certifi, and Wallcheck. This allows users to access relevant information within the context of the services they are using, reducing friction and improving the overall experience.
For example, users can move directly from understanding requirements to completing actions within the same environment. This connection between information and execution helps streamline workflows and reduces errors.
The transformation of documentation in Washington D.C. shows that digital government is not only about workflows and automation, but also about how delivered information supports those systems.
When documentation is structured, searchable, and easy to maintain, it becomes an active part of service delivery. It reduces internal workload, improves user experience, and enables systems to scale more effectively.
By adopting a Docs as Code approach, the Department of Buildings with platformOS created a system that is more maintainable, more accessible, and better aligned with modern digital services.
Across inspections, permit workflows, and documentation, the DOB in Washington D.C. with platformOS developed a comprehensive digital ecosystem supported by a shared platform.
Each phase of the transformation builds on the previous one, creating a system that is efficient, scalable and easier to manage. This approach allows the Department of Buildings to continue improving services over time, without the need for large-scale system replacements.
This transformation was not a single initiative, but a series of connected improvements:
From Fragmentation to Flow: How Washington D.C. Built a Digital Government
How a Marketplace Model Transformed Building Inspections
From Backlogs to Real-Time Government: Reinventing Permits and Inspections
Together, these steps show how platform-based approaches can support scalable, long-term transformation in the public sector.
Ensure your project’s success with the power of platformOS.
