Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: Re: [aspectj-dev] Online samples

From my point of a perspective yes.
Do what is easier to set up, to get the things started.

kind regards
   Arno

Wes Isberg <wes@xxxxxxxxxxxxxx> schrieb am 10.07.2003, 19:19:09:
> Hi Russell (and Nick)-
> 
> I like the idea of a wiki, but I'm not convinced yet.
> 
> Russell Miles wrote:
> > Hi Wez,
> > 
> > Would this site benefit from being a Wiki 
>  > to make it as easy as possible for contributors to add
>  > their samples etc? This would also make the source
>  > searchable.
> 
> The one HTML page will be organized by application
> and should be searchable.
> 
>  > This would not detract from a more frozen
>  > programming guide but would benefit from it being as easy
>  > and as open as possible for people to add their own works
>  > to the site for consideration as part of the more formal
>  > programming guide.
> 
> To contribute requires only sending an email to the mail
> list with the proposed sample.  That way, it's up for
> discussion regardless of committer attention, and doesn't
> change what users now do.  So it should be easier for
> the contributor than a wiki would be.
> 
> That way, rather than splitting discussions between the
> mail list and a wiki, the mail list continues to host
> all discussions.  Plus, users can also find good samples
> in one place, with links out to other AspectJ docs
> and in from mail lists, etc.
> 
> The committers moderate somewhat for quality and
> organization, and also can pull samples not originally
> intended for the samples page (after emailing the
> senders).  I hope contributors find committer moderation
> to be quick and to be a benefit rather than a hindrance.
> 
> If we get to the point that we have too many contributors
> and too much code for this format, or if the committers
> are not helping, we'll have to manage our success
> differently, perhaps using a wiki.
> 
> Sound reasonable?
> 
> Wes
> 
> > 
> > Cheers
> > 
> > Russ Miles
> > 
> > On Thursday, July 10, 2003, at 00:48AM, Wes Isberg  wrote:
> > 
> > 
> >>Let's make it easier for AspectJ users to find small AspectJ code
> >>samples by publishing HTML page(s) with linkable code and discussion.
> >>The code would include idioms and workaround, as well as
> >>task-oriented docs, e.g., "how do I set up Apache's JSP compiler
> >>to weave in my aspects?"  Some of what's in the FAQ now would move
> >>out to these sample pages, but the goal is that committers would
> >>migrate good code on the mailing list to the samples pages. (In
> >>theory, a "how to" question would never have to be asked twice.)
> >>These pages could be updated at any time, and incorporated into
> >>the Programmers Guide when that is revised, if appropriate.
> >>So we'll have...
> >>
> >>- code samples: online html snippets and tasks, links to all of...
> >>- examples:     programs in the distribution
> >>- idioms:       the programming guide section
> >>- exercises:    tutorial code
> >>
> >>Absent objection, I'll put up an initial version, linked off
> >>the docs page.  The goal is not to have a page maintainer, but
> >>for any committer to add code as appropriate (by contrast, the
> >>Programming Guide operates per our usual strong-lead model).
> >>
> >>Wes
> >>
> >>
> >>
> >>_______________________________________________
> >>aspectj-dev mailing list
> >>aspectj-dev@xxxxxxxxxxx
> >>http://dev.eclipse.org/mailman/listinfo/aspectj-dev
> >>
> >>
> > 
> > _______________________________________________
> > aspectj-dev mailing list
> > aspectj-dev@xxxxxxxxxxx
> > http://dev.eclipse.org/mailman/listinfo/aspectj-dev
> > 
> 
> _______________________________________________
> aspectj-dev mailing list
> aspectj-dev@xxxxxxxxxxx
> http://dev.eclipse.org/mailman/listinfo/aspectj-dev


Back to the top