How to organize a software architecture proposal document
An example from Microsoft:
Post-Avalon Operating Model
Section titled “Post-Avalon Operating Model”CVP Check-in #1
Date: 4/30/2024
Table of Contents
- Operating model across MSAI, Office AI (AugLoop), Turing, and the Core Copilot Platform Teams:
- Operating Principles - write down our approach wrt. tenets, progress, governance, release strategies, differentiation vs. cost leadership, enhancements & extensions, collaboration approach, excelling in the core vs. adapting and innovating
- Architecture Governance Council - stakeholder group design, roles, expectations, ICs vs. managers, seniority, expected contributions and work items, decision making process, meeting cadence, change control & reporting methods, escalations
- Investing in the Shared Copilot Platform - tracking method for one-off vs. product vs. platform investments, process for proposing work
- Empowering M365 Copilots - identifying use cases
- Bringing Consumer Features to Enterprise
- Avalon Phase 2 Plan - sketch out of plan as we currently know it
- Areas for CVP input/direction - build a risk register, areas that require stakeholder input along with timing & impact / mitigation of risks
- Appendix - include a table with the foundational design principles for core areas of work: headings are “Functionality Area”, “Design Principles”, and “Value Proposition”