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