Agile, SCRUM and Technical Writing
Peter Neilson
neilson at windstream.net
Fri Feb 16 12:09:13 MST 2007
Lemme try to think through what might be going on here. We can divide
software projects up into various binary categories:
1(a/b). Have (or do not have) a good insight on a product and a good team.
2(a/b). Perform (or do not perform) early documentation of plans and
designs.
3(a/b). Produce (or do not produce) a successful product.
1b rarely leads to 3a, I'm sure, regardless of what is done with 2.
Including a large number of badly conceived projects in a study will
indeed show that documentation efforts do not help. "You can't wash
sh*t," as a fellow TW once said.
So a proper study on the effectiveness of early documentation should
focus mostly on projects that were started by experienced and/or
cohesive teams working towards a reasonably well understood goal. But
how would one select those, the "1a" subgroup, from the entire 1a+1b?
How could one tell which is which?
The only way that I could imagine is by reading the planning and process
documents. Those are hard to come by for successful projects, because
they are generally proprietary. For failed projects they (if any) are
either going to be pieces of crap that are part of the failure, or
after-the-fact memoranda that show why someone else was to blame for the
failure. Once in a while they might be gold that was set aside in a vain
attempt to use the precious dross.
What have I come up with? Am I right, or am I instead all out of focus,
or involved in petitio principii, or perhaps merely echoing someone
else's much more erudite and well constructed research?
More information about the TECHWR-L
mailing list