{"id":15,"date":"2005-05-13T10:47:55","date_gmt":"2005-05-13T00:47:55","guid":{"rendered":"http:\/\/somethinkodd.com\/oddthinking\/?p=15"},"modified":"2007-10-07T20:55:26","modified_gmt":"2007-10-07T10:55:26","slug":"is-a-picture-worth-a-thousand-words","status":"publish","type":"post","link":"https:\/\/www.somethinkodd.com\/oddthinking\/2005\/05\/13\/is-a-picture-worth-a-thousand-words\/","title":{"rendered":"Is a picture worth a thousand words?"},"content":{"rendered":"<p><!-- UnMarkedDown_2_01132526258--><\/p>\n<p>A tutor at university once told us about a commercial software development project that she worked on, where the architecture was so complex that they had to draw the diagrams on a bedsheet, and the developers would take off their shoes and walk all over it in order to read it.<\/p>\n<p>At the time, I was impressed at the project&#8217;s complexity.<\/p>\n<p>A few years later, I recalled the story and became impressed at the architect&#8217;s incompetence.<\/p>\n<p>Unfortunately, I still see people trying to explain complex issues with similar diagrams. Universally, the audience members either get caught up with the details, scanning the diagram to trying to find items of interest in the mess, or they just vague out as a protective measure.<\/p>\n<p>Smaller, simpler diagrams work better. If the system is complex, present more of them, with carefully thought through layers of abstraction.<\/p>\n<p>Of course, there is a limit to this rule about small, simple, diagrams. I also see diagrams presented that could more easily be explained with a five word sentence.<\/p>\n<p>Is a picture is worth a thousand words? No, it&#8217;s not. Please don&#8217;t even try.  I think the sweet spot is around a hundred words, plus or minus fifty percent. Any more, and no-one will get it. Any less, and you&#8217;re wasting your time.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A short diatribe on information presentation<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_s2mail":"","footnotes":""},"categories":[23,24,31,21,34,26],"tags":[63,69,113],"class_list":["post-15","post","type-post","status-publish","format-standard","hentry","category-based-on-a-true-story","category-cathartic-rant","category-geek","category-observation","category-software-development","category-tribal-affiliation","tag-corporate-life","tag-software","tag-ui"],"_links":{"self":[{"href":"https:\/\/www.somethinkodd.com\/oddthinking\/wp-json\/wp\/v2\/posts\/15","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.somethinkodd.com\/oddthinking\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.somethinkodd.com\/oddthinking\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.somethinkodd.com\/oddthinking\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.somethinkodd.com\/oddthinking\/wp-json\/wp\/v2\/comments?post=15"}],"version-history":[{"count":0,"href":"https:\/\/www.somethinkodd.com\/oddthinking\/wp-json\/wp\/v2\/posts\/15\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.somethinkodd.com\/oddthinking\/wp-json\/wp\/v2\/media?parent=15"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.somethinkodd.com\/oddthinking\/wp-json\/wp\/v2\/categories?post=15"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.somethinkodd.com\/oddthinking\/wp-json\/wp\/v2\/tags?post=15"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}