Re: SDLC Documentation Help Requested

Subject: Re: SDLC Documentation Help Requested
From: Andrew Plato <intrepid_es -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Sun, 27 Jan 2002 02:14:37 -0800 (PST)

"Ed Manley" wrote

To echo some of Michael's comments, I don't think you have a documentation
problem. What you described is a management or personnel problem. It
sounds like your firm needs some key people with experience guiding and
managing development teams. A methodology cannot take the place of solid,
experienced management.

Once you have that, then you can start to address the "how to do things."
Creating a flurry of documents that nobody will read will only waste time
and eat up what resources you have.

As for documentation, again experience is the key. You Most programming
and development methodologies simply do not consider documentation needs.
Or if they do it is a periphery consideration.

You might consider hiring a writer or consulting firm with experience
developing documentation sets for rapidly growing companies. After a few
iterations, the writer should have an established system such that you can
swap in less experienced writers and migrate the experienced writer into
management or slowly devolve the out source relationship.

While processes you're studying are all good "templates" for establishing
internal dev processes, the ultimate task is to take the success you have
already had and duplicate it. The only way you'll get there is with some
seasoned veterans who understand how to build a corporate infrastructure.

Good luck.

Andrew Plato
President / Principal Consultant
Anitian Corporation
http://www.anitian.com


__________________________________________________
Do You Yahoo!?
Great stuff seeking new owners in Yahoo! Auctions!
http://auctions.yahoo.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Collect Royalties, Not Rejection Letters! Tell us your rejection story when you
submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of
your book. What are you waiting for? http://www.iuniverse.com/media/techwr

Have you looked at the new content on TECHWR-L lately?
See http://www.raycomm.com/techwhirl/ and check it out.

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Previous by Author: Re: Gift for those single-sourcing or API documentation projects
Next by Author: Re: SDLC Documentation Help Requested
Previous by Thread: SDLC Documentation Help Requested
Next by Thread: Re: SDLC Documentation Help Requested


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


Sponsored Ads