DocumentationIsNotExecutable

January 23, 2004
While there are those out there in Geekdom working on making ExecutableUML, that's not using English. There's a reason we don't code in English, it's a lousy computer language, it's too ambiguous.

I believe that DocsCannotBeTrusted, ultimately because I can't easily, automagically verify them to see if they accurately reflect the code. This is why unit tests have such a powerful advantage over planning ahead on paper. Ignoring comments from AgileAnders and AgileBrooks and others about the difficulty of design, and assuming a worst case scenario of many additional rewrites by getting into code too soon, unit tests always tell me quickly when I've veered away from the path I already trod out for my end users. Docs just can't do that.

tags: ComputersAndTechnology AgileDevelopment
comments powered by Disqus