As a newly minted analyst, I have come to appreciate how tolerant I have become to horrific writing. If you have ever had the privilege of working for multiple Fortune 100 enterprises, you would understand that documentation is often done by employees who were never trained to write and that Enterprise Architects consume much of the most poorly written information ever conceived.
Every Enterprise Architect worth his or her salt understands the importance of good communication, yet the vast majority of practitioners have done little if any to improve their own writing skills. We have many inefficient organizational processes that tolerate bad writing. Have you ever read the documentation written by an offshore developer whose native language is not English? The funny thing is that offshore gets most of the complaints in this regard but many onshore employees are guilty of a crime more heinous in the sense that they often can do better but choose not to.
How many times have we seen organizations build so-called “knowledge transfer” processes on top of this weak foundation? Scholars have various accepted formulas for determining the grade reading level of any piece of writing based on how complex it is, what kind of vocabulary uses it, etc. The most common scale is the Flesch-Kincaid index. I have two children (both boys) in school. Teachers provide updates to my wife and I on their progress using this standard. I wonder somehow ignore this same thinking as parents in the work environment?
Enterprise Architects love standards! We have all sorts of standards. Need a “standard” for where to place content on “sharepoint”? Check! Need a for what is considered acceptable documentation to aid in comprehension? Missing in Action.
I ran across an article that shares this disturbing graph:
The reason for me sharing this is to outline a belief I am starting to embrace. In order to deliver better business outcomes, Enterprise Architects must be front-and-center in both eliminating complexity with the IT ecosystem, but also complexity in how IT communicates at large…
View Free, Relevant Gartner Research
Gartner's research helps you cut through the complexity and deliver the knowledge you need to make the right decisions quickly, and with confidence.Read Free Gartner Research
Comments or opinions expressed on this blog are those of the individual contributors only, and do not necessarily represent the views of Gartner, Inc. or its management. Readers may copy and redistribute blog postings on other blogs, or otherwise for private, non-commercial or journalistic purposes, with attribution to Gartner. This content may not be used for any other purposes in any other formats or media. The content on this blog is provided on an "as-is" basis. Gartner shall not be liable for any damages whatsoever arising out of the content or use of this blog.