Welcome to my standard solution architecture document template, which I have developed and continuously refined through two decades, and introduced in numerous corporations as their new standard.
I continue to use it when working as a freelance solution architecture for client, if they don’t already have their own mandatory template in place.
If they do – which isn’t often – I will certainly hold it up against my own standard, and offer suggestions for improvements to their documentation practices.
This template is not only useful for other solution architects. If you are a project manager or in any other role in a project, or a stakeholder in a project, this template can help you determine if the project is delivering architecture documentation of sufficient quality to address all relevant concerns, including adequately support longterm maintenance of the solution being built.
If you’re about to prepare a request for proposal to have vendors bid on the solution, I recommend that you specify exactly how you want the solution architecture to be documented as part of the delivery.
I have been involved in many RFPs, and helped evaluate the proposals, and to this day I have never seen any vendor present a meaningful architecture documentation template. Don’t leave it up to the vendor – demand that they follow your standard!