It would be nice to see graphics representation of the software architecture in a README.md > It then gets saved as PDF and shelved as an artefact that is disc

It would be nice to see graphics representation of the software architecture in a README.md > It then gets saved as PDF and shelved as an artefact that is disconnected from all the other architectures, and the system boundaries are inevitably out of date by the time the next person looks at it. Personally, I think documentation should be stored into source control like git. Any changes needs to go thru this document first. Specification by Example is one I think would be beneficial. However, all of these takes human willpower and disciple and business buy-in... and is probably why I'm stuck reading an ultra-slow confluence that is not updated.