[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
|
Re: [aspectj-dev] Online samples
|
Sounds good to me!
Time to get working on some samples I guess ;o)
On Thursday, July 10, 2003, at 06:19 pm, Wes Isberg wrote:
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
<wes@xxxxxxxxxxxxxx> 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
