To Software Architects: Serve End Users, Not Your Egos
Dave is dead-on, absolutely right. Software architect has to ensure the documentation or the artifacts he delivers is actually usable. The documentation should be designed to suite the needs of the consumers or architectural stake holders (Business, Engineering, Dev, Quality, support, Data teams, etc.) and it is not meant to be compliant to some industry buzz which will be totally obsure to the actual consumers. Architects should thrive to communicate the most complex probelms is the most simplistic terms.