Prior Art
Eric "Shubes"
plug-devel@lists.PLUG.phoenix.az.us
Tue Mar 29 08:08:02 2005
I'm thinking along the same lines as Bryan.
Bryan.ONeal@asu.edu wrote:
> Without proper documentation it is very difficult to
> 1) Understand what your needs are and develop a solution to fit them:
> I am not saying we write up a 30page purposely but some built points
> and a implantation map, suggesting some general object and their external
> functions and API names would be Extremely nice... Especially since we could
> probably knock out the generals of the plane in just a few 1-2 hour meeting.
> 2) Utilize code others have developed.
> Simply knowing what code is in your project and how to tape it will
> ensure you don't have to constantly reinvent the weal.
> 3) Know where you are and where you're going
> We are already suffering from scope creep because we don't have a
> clearly defined scope. If we did we would be able to say TicketMaster does
> not fit within our scope. We can revisit it after the implementation of
> current phases is done.
>
> You can not just start coding without knowing what your coding!
>
> Since most projects fail due to different operating styles of the volunteers,
> I feel agreement with vision, style, and environment to be extremely
> important. I, however, see defined scope, function maps, and vague class
> diagrams, to be key elements in facilitating a cohesive programming
> environment. As for documenting your code, you should do it anyway, how else
> will you know what you did six months latter, let alone have some one else
> know what you did. However, if the rest of the group feels different, then I
> must assume I am a hindrance to the implementation and will gracefully remove
> my name from the development team and quietly watch, with keen interest, from
> the sidelines.
>
> Although, in truth, we may be disagreeing du to a misunderstanding on what
> documentation is and should be. Sort of a comparison of Tangerines and
> Oranges ;)
>
> Perhaps we can find a good Tangelo to agree on; perhaps not.
>
<snip>
--
-Eric 'shubes'
"There is no such thing as the People;
it is a collectivist myth.
There are only individual citizens
with individual wills
and individual purposes."
-William E. Simon (1927-2000),
Secretary of the Treasury (1974-1977)
"A Time For Truth" (1978), pg. 237