commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rahul Akolkar <>
Subject Re: [Digester] working toward a release
Date Tue, 31 Aug 2010 21:51:43 GMT
On Tue, Aug 31, 2010 at 12:02 PM, sebb <> wrote:
> On 31 August 2010 14:39, Simone Tripodi <> wrote:
>> Hi Rahul,
>> I just added the xdoc version of the documentation present in the
>> package.html files.

Nice. BTW, you can even deploy the site if you mark the menu heading
as "Guide (SVN latest)" or some such. The [digester] site is fairly
well structured so may be deployed between releases.

> The package.html files are normally used to annotate the Javadoc output.
> However in this case these files have got a lot more content than is
> normally present in the Javadoc.
>> Do you think these last can be removed, since
>> would be redundant with the new developers guide?

I checked and it doesn't look like there are a lot of non-Commons
sites that link to the old package guide. So I think its OK to remove
(and we certainly don't want two copies to get out of sync).

> There should at least be minimal package.html files for Javadoc usage,
> so I don't think the files should be removed entirely, but they could
> be replaced with much simpler versions.
>> At this stage, we
>> should maintain two different data sources with same information, I'd
>> propose to drop the existing one, but let choose together.
>> Another small question: in src/conf there is a MANIFEST.MF[1] file
>> that contains informations that maven can generate automatically, do
>> you think we can drop it, when dropping the ant build?
> +1 to dropping MANIFEST.MF.

Yup, its legacy stuff, +1 to removal as well.


>> Thanks in advance, have a nice day!
>> Simo
>> [1]

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message