Back in March last year we published an initial set of software architecture document guidelines and I thought that it was time for an update. There are no major changes although I've modified some of the section headings so that you can use this as a complementary resource to the slides from my Documenting your software architecture - why and how? presentation. As before, I hope you find these resources useful in creating your own software architecture documentation.
Simon is an independent consultant specializing in software architecture, and the author of Software Architecture for Developers (a developer-friendly guide to software architecture, technical leadership and the balance with agility). He’s also the creator of the C4 software architecture model and the founder of Structurizr, which is a collection of open source and commercial tooling to help software teams visualise, document and explore their software architecture.
You can find Simon on Twitter at @simonbrown ... see simonbrown.je for information about his speaking schedule, videos from past conferences and software architecture training.
First, I really appreciates the job you have done on software architecture document guidelines. I have already used the first revision of it on my current project.
Second, It is possible to see a real sample of the architecture document with every sections? I looked at the "why and how" presentation and it demonstrates the diagrams part of the software arhictecture document not so much on the textual part. I would like to see an example of the other sections. I haved encounter many difficulties on how to present the informations. I'm sure it will a lot of people.
Thanks.
N.B.: Sorry for my poor english