Re: When to write in less-than-perfect Agile

Subject: Re: When to write in less-than-perfect Agile
From: "Peter Neilson" <neilson -at- windstream -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 01 Apr 2014 10:15:44 -0400

If a project has two parts, and part 2 dev can't start until part 1 is nearly complete, but nobody quite understands that it's two parts, you'll be chasing the part 2 specs, trying to write something. What could be worse? Well, part 2 could require far less effort than was allocated, and your writing team will be unable to produce much of anything, perhaps because the Javadoc that finally emerged from part 1 covered everything that needed to be said for part 2.

All the while you'll be attending those scrums where minute details of inner workings are being corrected...

DEV: "We've changed to a different hashing algorithm."
WRI: "Okay, and how does that affect the doc set?"
DEV: "It shouldn't, not at all."

WRI: "So what does the user interface actually look like?"
DEV: "We'll tell you when we figure it out. If we need one at all. A lot of the parameters will be self adjusting."
WRI: "Good enough. What are the ones that'll need tweaking by the user?"
DEV: "We don't know yet."

I have no solution to the problem.
Doc-To-Help 2014 v1 now available. SharePoint 2013 support, NetHelp enhancements, and more. Read all about it.

Learn more:


You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


When to write in less-than-perfect Agile: From: McLauchlan, Kevin

Previous by Author: Re: Categorize Import/Export
Next by Author: Re: When to write in less-than-perfect Agile
Previous by Thread: When to write in less-than-perfect Agile
Next by Thread: RE: When to write in less-than-perfect Agile

What this post helpful? Share it with friends and colleagues:

Sponsored Ads