radical revamping of techpubs

Gordon McLean Gordon.McLean at GrahamTechnology.com
Thu Oct 18 07:46:44 PDT 2007


>
> The movement toward Extreme Programming and Agile Development is a 
> case in point; documentation is considered a waste of valuable 
> developer time, and only needs to be slapped together in minimalist 
> form at the last minute. That is at odds with the "TW perspective"
> of involvement during the entire development process (which is ONLY 
> appropriate for Waterfall, because everything else changes).
>

Tosh.

http://www.agilemodeling.com/essays/agileModelingXP.htm#Documentation

"Outside your extreme programming project, you will probably need
documentation: by all means, write it. Inside your project, there is so much
verbal communication that you may need very little else.  Trust yourselves
to know the difference."

Ohhh wait, you mean that internal documentation is a waste of time, not
customer facing (and requested) documentation. Right?

That'll be why, as one of three technical authors working within an XP
driven development team (and I mean within as in sitting alongside,
contributing to design discussions, arguing UI points, trying early builds)
we are struggling to keep up with the (external) documentation requirements.

Gordon



____________________________________________________________________________________________________
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
____________________________________________________________________________________________________




More information about the framers mailing list