[Javascript] PROPOSAL for An Annotated JavaScript Project, Pls Give YourFeedback On This

[Ben]

I'm up for this.  I'm not sure how much I can help out or of the quality of
my work but it sounds like a great idea.  Also, on the subject of annotation
be sure to check out http://www.php.net/manual/en/ for an annotated manual
for PHP - shame there isn't once for JS.

 .b

> -----Original Message-----
> From: javascript-admin at LaTech.edu [mailto:javascript-admin at LaTech.edu]On
> Behalf Of Robin Warnes
> Sent: 06 June 2001 00:36
> To: javascript at LaTech.edu
> Subject: Re: [Javascript] PROPOSAL for An Annotated JavaScript Project,
> Pls Give YourFeedback On This
>
>
> I second that
>
> Robin
> New Zealand.
>
> ----- Original Message -----
> From: Andrew Dunn <adunn at mail.interworx.com.au>
> To: <javascript at LaTech.edu>
> Sent: Wednesday, June 06, 2001 11:25 AM
> Subject: RE: [Javascript] PROPOSAL for An Annotated JavaScript
> Project, Pls
> Give YourFeedback On This
>
>
> > Hi,
> >    As a learning Javascript programmer i think this would be
> excellent. I
> > think it would be excellent to have it on this list, i'm looking forward
> to
> > it. I think it would be good to have peoples view's on different way so
> > doing scripts and see what comes out as the preferred way. As a learner
> who
> > teaches myself, i'm always wondering if i'm doing things "the
> right way".
> >
> > Regards,
> >
> > Andrew
> >
> > -----Original Message-----
> > From: javascript-admin at LaTech.edu [mailto:javascript-admin at LaTech.edu]On
> > Behalf Of David Merchant
> > Sent: Wednesday, 6 June 2001 3:05 AM
> > To: javascript at LaTech.edu
> > Subject: [Javascript] PROPOSAL for An Annotated JavaScript Project, Pls
> > Give YourFeedback On This
> >
> >
> > [new subject line to hopefully catch the eye of more of our list members
> > and a few added thoughts]
> >
> > Just tossing an idea out for debate/discussion for those interested.
> >
> > For those that may be interested, I'm proposing a project called "The
> > Annotated JavaScript Project". There may be already something
> like it, and
> > that's fine, don't want to reinvent the wheel, but so far I've only seen
> > JavaScripts offered with some install or use instructions, or minimal
> > annotations.  I propose that if enough people are interested in
> it (i.e.,
> > are interested in participating!), we would set up a repository of
> > JavaScripts that are *heavily* annotated: line by line.  Every
> single line
> > is annotated or explained.  There are different learning styles, for
> > instance: some people learn best from books, others from just
> jumping in,
> > others from watching someone first, and so forth.  I believe that
> Annotated
> > JavaScripts would be of great help for some folks.
> >
> > We can approach this in different ways.  We could have a separate list
> just
> > for the project, though I'd prefer to keep it on this list, there are
> > members and lurkers who could benefit from the process.  Then there are
> > some "story" Perl scripts out there that I can set up where a JavaScript
> > script is posted and people can annotate any line they wish, it is
> "checked
> > out" so that only a person at a time can make comments/annotations.  And
> > you can comment on the comments.  Or just have people present their
> > annotations to the list, people discuss those annotations, and / or a
> > peer-reviewed approved version is then put up.  Peer-reviewed by any
> > interested, or have a volunteer panel/board.  I'm sure there are other
> ways
> > to approach this as well.
> >
> > Anyway, let me know how you feel about it, and how best it
> should be done
> >
> > TTFN,
> > David Merchant
> >
> > Head, Systems Dept, Louisiana Tech University
> > merchant at latech.edu
> > JavaScript List Administrator (www.mountaindragon.com/javascript/)
> > Webmaster, HTML Encyclopedia (www.mountaindragon.com/html/)
> > Webmaster, Memorial Day Page: (www.usmemorialday.org/)
> >
> >
> > _______________________________________________
> > Javascript mailing list
> > Javascript at LaTech.edu
> > http://www.LaTech.edu/mailman/listinfo/javascript
> >
> >
> > _______________________________________________
> > Javascript mailing list
> > Javascript at LaTech.edu
> > http://www.LaTech.edu/mailman/listinfo/javascript
> >
>
>
> _______________________________________________
> Javascript mailing list
> Javascript at LaTech.edu
> http://www.LaTech.edu/mailman/listinfo/javascript
>