Documentation and Knowledge Management

The DevX team maintains documentation across several locations depending on its purpose and audience. Understanding where to find documentation and how to contribute to it is important for both new joiners and existing team members.

For a full breakdown of what lives where and why, refer to the Documentation Structure Proposal developed as part of issue 170. This proposal covers the team’s documentation locations, content lifecycle, and versioning conventions.

A quick reference summary is also available below - for day-to-day navigation, this should be your first port of call.

What Lives Where?

Documentation Type	SharePoint	DevX-Documentation-Site	Repo READMEs	Engineering Portal / Blueprint
Meeting Notes	✅	❌	❌	❌
Decision Logs	✅	✅ (ADRs)	❌	❌
Sprint Reviews	✅	❌	❌	❌
Audit / Ticket Findings	✅ (Raw)	✅ (Refined)	❌	❌
Tooling Setup and Usage Guides	❌	✅	✅ (Quickstart)	❌
Runbooks	❌	✅	❌	❌
Org-Wide Standards and Guidelines	❌	❌	❌	✅
Onboarding Guides	❌	✅	❌	❌

SharePoint Index

For a full inventory of internal team documentation, including audit findings, POC outputs, and sprint artefacts, refer to the DevX SharePoint Index.

This page was last reviewed on 16 July 2026. It needs to be reviewed again on 16 January 2027 by the page owner #developer-experience-alerts .