XP and Agile are excuses for bad behavior. "We're manly men who code
brilliantly; we don't need documentation because our code is perfect
and if the users don't understand our godlike design, that's their
problem." XP and Agile will get code out the door and it may even be
good code (occasionally), but it ignores the idea that 90% of
programming is maintenance... and without internal documentation or
process, you have no history.
I've seen XP happening in a number of companies that are now
dead. Think of it as evolution in action.
Yours truly,
John Hedtke
Author/Consultant/Contract Writer
www.hedtke.com <-- website
541-685-5000 (office landline)
541-554-2189 (cell)
[EMAIL PROTECTED] (primary email)
[EMAIL PROTECTED] (secondary email)
At 07:46 AM 10/18/2007, Gordon McLean wrote:
>
> 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
____________________________________________________________________________________________________
_______________________________________________
You are currently subscribed to Framers as [EMAIL PROTECTED]
Send list messages to [EMAIL PROTECTED]
To unsubscribe send a blank email to
[EMAIL PROTECTED]
or visit http://lists.frameusers.com/mailman/options/framers/john%40hedtke.com
Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.
_______________________________________________
You are currently subscribed to Framers as [EMAIL PROTECTED]
Send list messages to [EMAIL PROTECTED]
To unsubscribe send a blank email to
[EMAIL PROTECTED]
or visit
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com
Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.
