{"id":128,"date":"2008-04-16T06:39:48","date_gmt":"2008-04-16T14:39:48","guid":{"rendered":"http:\/\/zuill.us\/WoodyZuill\/?p=128"},"modified":"2008-05-05T10:16:53","modified_gmt":"2008-05-05T18:16:53","slug":"communication-problems-with-the-waterfall","status":"publish","type":"post","link":"https:\/\/zuill.us\/WoodyZuill\/2008\/04\/16\/communication-problems-with-the-waterfall\/","title":{"rendered":"Communication Problems with the Waterfall"},"content":{"rendered":"<p>One set of problems I have often seen with &#8220;the Waterfall&#8221; are\u00a0the Communications Problems, particularly the over-reliance on communication by documents.\u00a0<\/p>\n<p><strong>Communication-By-Documentation (CBD) &#8211;\u00a0What&#8217;s so bad about that?<\/strong><\/p>\n<p>It seems so correct and natural to use documents to\u00a0capture\u00a0and communicate all the details of what we are working on that it is almost unthinkable to question this practice.\u00a0 But I am going to try.<\/p>\n<p>The sort of documentation I am discussing here are requirement docs, graphs, ER diagrams, models of all sorts, analysis docs, architectural diagrams, and etc.\u00a0 (There is a lot of etc., by the way.\u00a0)\u00a0 I am not saying\u00a0that\u00a0documentation is not needed,\u00a0or that it is not useful, it is just that we have to be careful to protect our project from the problems that these documents bring with them.\u00a0\u00a0<!--more-->[NOTE: I am NOT talking about user documentation &#8211; things like help docs, instruction manuals, support group FAQ&#8217;s&#8230; these things are part of what the user expects as part of the project]<\/p>\n<p>Here is a short list of some of the problems of communication-by-documentation\u00a0I&#8217;d like to cover:<\/p>\n<ul>\n<li><a href=\"http:\/\/zuill.us\/WoodyZuill\/2008\/05\/05\/you-cant-test-documents-for-correctness-or-completeness\/\">No way to test for correctness or completeness<\/a><\/li>\n<li>Its &#8220;Lossy&#8221; &#8211; the most important and valuable information remains in the brain of the author<\/li>\n<li>Becomes outdated quickly and is often not kept up to date<\/li>\n<li>No easy way to discover stuff not thought about<\/li>\n<li>Especially hard to do in a high pressure, strict deadline situation<\/li>\n<li>Wasteful repetition from phase-to-phase<\/li>\n<li>Lots of other opportunities for waste<\/li>\n<li>Suffers from the &#8220;telephone game&#8221; syndrome &#8211; information gets garbled as it is passed along.<\/li>\n<li>Documents are essentially &#8220;one-way&#8221; devices<\/li>\n<li>CBD causes lengthy feedback loops<\/li>\n<li>In some cases,\u00a0changes and corrections\u00a0are difficult or impossible to inject<\/li>\n<\/ul>\n<p>There are many more, but I think these will get the discussion started.\u00a0 As time goes by, perhaps I&#8217;ll add more to the list.\u00a0 As I flesh out the details of each of these in separate posts\u00a0I&#8217;ll turn the list into links.\u00a0<\/p>\n<p>If you have any thoughts about other communication problems with Waterfall, please let me know and I&#8217;ll add them to the list.<\/p>\n<p>\u00a0<\/p>\n","protected":false},"excerpt":{"rendered":"<p>One set of problems I have often seen with &#8220;the Waterfall&#8221; are\u00a0the Communications Problems, particularly the over-reliance on communication by documents.\u00a0 Communication-By-Documentation (CBD) &#8211;\u00a0What&#8217;s so bad about that? It seems so correct and natural to use documents to\u00a0capture\u00a0and communicate all the details of what we are working on that it is almost unthinkable to question [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-128","post","type-post","status-publish","format-standard","hentry","category-waterfall"],"_links":{"self":[{"href":"https:\/\/zuill.us\/WoodyZuill\/wp-json\/wp\/v2\/posts\/128","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/zuill.us\/WoodyZuill\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/zuill.us\/WoodyZuill\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/zuill.us\/WoodyZuill\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/zuill.us\/WoodyZuill\/wp-json\/wp\/v2\/comments?post=128"}],"version-history":[{"count":1,"href":"https:\/\/zuill.us\/WoodyZuill\/wp-json\/wp\/v2\/posts\/128\/revisions"}],"predecessor-version":[{"id":797,"href":"https:\/\/zuill.us\/WoodyZuill\/wp-json\/wp\/v2\/posts\/128\/revisions\/797"}],"wp:attachment":[{"href":"https:\/\/zuill.us\/WoodyZuill\/wp-json\/wp\/v2\/media?parent=128"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/zuill.us\/WoodyZuill\/wp-json\/wp\/v2\/categories?post=128"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/zuill.us\/WoodyZuill\/wp-json\/wp\/v2\/tags?post=128"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}