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