radical revamping of techpubs

[Neeraj Jain]

I agree with Gordon. Infact, there is requirement for more and more documentation. I see that every new user interface comes with its own set of tutorials.
 

Smile makes you more close; try it
Thanks and Regards, 
N. Jain 
Writer 
91-9810676241
http://www.neerajjain8.com | http://neerajjain8.rediffiland.com


 


----- Original Message ----
From: Gordon McLean <Gordon.McLean at GrahamTechnology.com>
Cc: framers at lists.frameusers.com
Sent: Thursday, October 18, 2007 8:16:44 PM
Subject: RE: radical revamping of techpubs



>
> 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 neerajjain8 at yahoo.com.

Send list messages to framers at lists.frameusers.com.

To unsubscribe send a blank email to 
framers-unsubscribe at lists.frameusers.com
or visit
 http://lists.frameusers.com/mailman/options/framers/neerajjain8%40yahoo.com

Send administrative questions to listadmin at frameusers.com. Visit
http://www.frameusers.com/ for more resources and info.





__________________________________________________
Do You Yahoo!?
Tired of spam?  Yahoo! Mail has the best spam protection around 
http://mail.yahoo.com