Writing the User Docs first?

[Gordon McLean]

Note: I work in a Dev team that uses the XP (Agile) development methodology.
 
Given that, in XP, there is a focus on little to no documentation during the
design/build of the software, I've been pondering how the Publications team
can fill that gap, namely by writing as complete a draft as early as
possible and getting buy-in from the Dev team that they'll use the user docs
whilst developing the software.
 
Sound odd? Yeah it might.
 
We sit in on early design discussions and at that point we can start to
capture the whys and whats, fleshing out the main concepts and viewing each
story (the large chunk of work the Dev team work on) from the point of view
of the user. Once those stories are futher broken down into smaller chunks
of work, we too will have a better idea of what is involved and can update
the documentation accordingly.
 
It will mean working closely with development, but we do that already, and
hopefully this will provide the (currently missing) big picture information
and view.
 
Am I barking mad? Anyone working in XP (or any other Agile environment) care
to chip in? Are our processes broken?
 
Gordon
 
(I've written more on this: www.onemanwrites.co.uk)

____________________________________________________________________________________________________
This email (and any attachments) is private and confidential, and is intended solely for the
addressee. If you have received this communication in error please remove it and inform us via
telephone or email. Although we take all possible steps to ensure mail and attachments
are free from malicious content, malware and viruses, we cannot accept any responsibility
whatsoever for any changes to content outwith our administrative bounds. The views represented
within this mail are solely the view of the author and do not reflect the views of the organisation
as a whole.
____________________________________________________________________________________________________
Graham Technology plc
Registered in Scotland company no. SC143434
Registered Office India of Inchinnan, Renfrewshire, Scotland PA4 9LH
                                                
http://www.grahamtechnology.com
____________________________________________________________________________________________________