Skip to Content

AI Policy & Governance, CDT AI Governance Lab

Report – Improving Governance Outcomes Through AI Documentation: Bridging Theory and Practice 

Graphic for CDT report, entitled "Improving Governance Outcomes Through AI Documentation: Bridging Theory and Practice." Illustration of several overlapping panels that show: a man on his computer, a hand writing on a stack of documents, a file cabinet with a drawer open, assembly instructions, a network, and a diagram showing a hexagon key screw, user icons and chat bubbles.
Graphic for CDT report, entitled “Improving Governance Outcomes Through AI Documentation: Bridging Theory and Practice.” Illustration of several overlapping panels that show: a man on his computer, a hand writing on a stack of documents, a file cabinet with a drawer open, assembly instructions, a network, and a diagram showing a hexagon key screw, user icons and chat bubbles.

Executive Summary

AI documentation is a foundational tool for governing AI systems, via both stakeholders within and outside AI organizations. It offers a range of stakeholders insight into how AI systems are developed, how they function, and what risks they may pose. For example, it might help internal model development, governance, compliance, and quality assurance teams communicate about and manage risk throughout the development and deployment lifecycle. Documentation can also help external technology developers determine what testing they should perform on models they incorporate into their products, or it could guide users on whether or not to adopt a technology. While documentation is essential for effective AI governance, its success depends on how well organizations tailor their documentation approaches to meet the diverse needs of stakeholders, including technical teams, policymakers, users, and other downstream consumers of the documentation.

This report synthesizes findings from an in-depth analysis of academic and gray literature on documentation, encompassing 37 proposed methods for documenting AI data, models, systems, and processes, along with 21 empirical studies evaluating the impact and challenges of implementing documentation. Through this synthesis, we identify key theoretical mechanisms through which AI documentation can enhance governance outcomes. These mechanisms include informing stakeholders about the intended use, limitations, and risks of AI systems; facilitating cross-functional collaboration by bridging different teams; prompting ethical reflection among developers; and reinforcing best practices in development and governance. However, empirical evidence offers mixed support for these mechanisms, indicating that documentation practices can be more effectively designed to achieve these goals.

Our report also outlines the design trade-offs organizations must consider when developing and implementing documentation strategies. For example, customized documentation can address specific risks but may reduce comparability across documentation artifacts, whereas standardized formats promote consistency and institutionalize norms of practice but may overlook details relevant to particular systems. Organizations may also face decisions about whether to create a single, general-purpose documentation artifact or multiple tailored artifacts; while the multiple tailored formats may better serve diverse stakeholders, they are more challenging to maintain. Also, organizations must carefully determine the appropriate level of detail to include in documentation artifacts—excessive information can overwhelm users, while insufficient detail may omit critical information. We also explore the trade-offs involved in automating the documentation process and the choice of whether to develop interactive interfaces that allow stakeholders to explore the documentation more thoroughly.

The report concludes with recommendations for designing effective documentation processes. These include realistically assessing an organization’s capacity for implementation, identifying the needs of key stakeholders, prioritizing essential details, and regularly evaluating progress against specific success criteria.

By carefully designing and implementing documentation processes that address the needs of diverse stakeholders, organizations can establish a strong foundation for robust AI system risk management. Moreover, by regularly assessing and refining their documentation practices, organizations can contribute to improved AI governance over time.

Read the full report.