Taking some ideas from my colleagues about contrib in opensource ...
When you go to a site and download stuff it is helpful if it works
(together?).
A contrib where you unpack and things don't work is annoying.
javadoc quality improves if it is all made in one go.
My understanding of the proposal is:
- standard distribution
No contrib
- jumbo distribution
Standard + contrib
If you require each part of the contrib to have an ant script that has some
known targets the process is made easier.
Including a "test" target allows sanity checking that this contrib does work
with the current release of the standard distribution (and other contribs it
depends on). Parts of contrib that fail the test are minimally marked as
known not to work in the jumbo distribution, or perhaps excluded from jumbo.
The master ant script needs to be able to invoke javadoc over all the source
for everything (except the stuff that fails test). Then the javadoc in
contrib would have all the links in it.
An issue is getting the right balance between being kind to the user and
kind to the maintainer.
Jeremy
> -----Original Message-----
> From: Andy Clark [mailto:[EMAIL PROTECTED]]
> Sent: 08 August 2001 09:07
> To: [EMAIL PROTECTED]
> Subject: Re: [Xerces2] Bundling and Packaging
>
>
> Edwin Goei wrote:
> > +1, sounds good to me. I'd support moving portions of code that
> > are not maintained and which few people use to a separate package.
>
> Exactly. How do you feel about creating a new "contrib" directory
> in the xml-xerces module where this code is placed? It would then
> be required to have its own Ant build script and would NOT be
> built and packaged into a Xerces2 release by default.
>
> What about documentation and such? Where would that go? Who would
> be responsible for generating the JavaDocs? etc.
>
> I'm more than willing to do the work required to separate all of
> this stuff. But I'd like to figure out the right thing to do
> first. Any ideas you have would be great.
>
> --
> Andy Clark * IBM, TRL - Japan * [EMAIL PROTECTED]
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
