{"id":2317,"date":"2016-11-24T01:06:13","date_gmt":"2016-11-24T06:06:13","guid":{"rendered":"http:\/\/dwaynephillips.net\/workingup\/?p=2317"},"modified":"2016-11-02T08:19:59","modified_gmt":"2016-11-02T13:19:59","slug":"when-documentation-is-more-valuable-than-working-software","status":"publish","type":"post","link":"https:\/\/dwaynephillips.net\/workingup\/2016\/11\/when-documentation-is-more-valuable-than-working-software\/","title":{"rendered":"When Documentation is More Valuable than Working Software"},"content":{"rendered":"<p>by Dwayne Phillips<\/p>\n<p><strong>Working software is more valuable than documentation\u2014except when it isn&#8217;t. And we have Dwayne&#8217;s Declaration.<\/strong><\/p>\n<p>Part of <a href=\"http:\/\/agilemanifesto.org\/\">the Agile Manifesto<\/a> states:<\/p>\n<blockquote><p>We&#8230;value working software over comprehensive documentation<\/p><\/blockquote>\n<p>Some of us are old enough to have known this years before the manifesto was manifest. Of course we wanted working software, except when we didn&#8217;t.<\/p>\n<p>So here I go, kill me, but<\/p>\n<blockquote><p>Documentation is more valuable than working software (in some cases).<\/p><\/blockquote>\n<p>Valuable documentation&#8230;<\/p>\n<ul>\n<li>is that which comes from thoughtful and rigorous analysis<\/li>\n<li>explains the situation for which software is assumed to be the solution<\/li>\n<li>shows when it is better to just do the right thing at work and not waste money on new software<\/li>\n<\/ul>\n<p>Finally, valuable documentation<\/p>\n<ul>\n<li>shows us when we don&#8217;t need any more software<\/li>\n<\/ul>\n<p>Please note the first bullet above. Documentation that is more valuable than working software comes about only after <em>thoughtful<\/em> and <em>rigorous<\/em> analysis. That type of work is common sense, but not common practice.<\/p>\n<blockquote><p>Let us Think before we Work.<\/p><\/blockquote>\n<p>Hmmm, perhaps that should have been in the Agile Manifesto. Let&#8217;s call it Dwayne&#8217;s Declaration. Of course it isn&#8217;t new. Many of us are old enough to have known this for years.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>by Dwayne Phillips Working software is more valuable than documentation\u2014except when it isn&#8217;t. And we have Dwayne&#8217;s Declaration. Part of the Agile Manifesto states: We&#8230;value working software over comprehensive documentation Some of us are old enough to have known this years before the manifesto was manifest. Of course we wanted working software, except when we [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[99,238,116,32,115,9,50,67],"tags":[228,154,227,132,172,187],"class_list":["post-2317","post","type-post","status-publish","format-standard","hentry","category-agility","category-analysis","category-authentic","category-communication","category-engineering","category-management","category-thinking","category-work","tag-authentic","tag-communication","tag-engineering","tag-management","tag-thinking","tag-work"],"_links":{"self":[{"href":"https:\/\/dwaynephillips.net\/workingup\/wp-json\/wp\/v2\/posts\/2317","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dwaynephillips.net\/workingup\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dwaynephillips.net\/workingup\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dwaynephillips.net\/workingup\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/dwaynephillips.net\/workingup\/wp-json\/wp\/v2\/comments?post=2317"}],"version-history":[{"count":1,"href":"https:\/\/dwaynephillips.net\/workingup\/wp-json\/wp\/v2\/posts\/2317\/revisions"}],"predecessor-version":[{"id":2318,"href":"https:\/\/dwaynephillips.net\/workingup\/wp-json\/wp\/v2\/posts\/2317\/revisions\/2318"}],"wp:attachment":[{"href":"https:\/\/dwaynephillips.net\/workingup\/wp-json\/wp\/v2\/media?parent=2317"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dwaynephillips.net\/workingup\/wp-json\/wp\/v2\/categories?post=2317"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dwaynephillips.net\/workingup\/wp-json\/wp\/v2\/tags?post=2317"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}