You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Oliver Heger <ol...@oliver-heger.de> on 2006/05/22 20:45:43 UTC
[site]Sites for snapshots published
Hi,
I just noticed that recently the sites of some components have been
deployed directly from their svn trunk. So the sites refer to snapshot
versions (e.g. BeanUtils, Configuration, Math, ...). Was this done by
intension?
It might be confusing for users if the sites describe features that are
not contained in the latest releases.
Oliver
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: [site]Sites for snapshots published
Posted by Phil Steitz <ph...@gmail.com>.
On 5/22/06, robert burrell donkin <ro...@blueyonder.co.uk> wrote:
> On Mon, 2006-05-22 at 20:45 +0200, Oliver Heger wrote:
> > Hi,
> >
> > I just noticed that recently the sites of some components have been
> > deployed directly from their svn trunk. So the sites refer to snapshot
> > versions (e.g. BeanUtils, Configuration, Math, ...). Was this done by
> > intension?
>
> yep - i did it. i went through and changed siteAddress then redeployed
> each site.
>
> please feel free to jump in and redeploy anything that isn't right.
>
> > It might be confusing for users if the sites describe features that are
> > not contained in the latest releases.
>
> IMHO it's a trade off. users get to see all the features that are
> available but have to actively search for documentation related to the
> version they have downloaded.
>
> many components provide link to the released documentation (for example
> http://jakarta.apache.org/commons/logging/) though it would probably be
> a good idea to add an indication on the navigation bar that these
> documents apply to the latest code...
That is a best practice that at least [collections], [math] and [lang]
at least all use. The important thing is to have the javadoc links
correctly labelled in the nav, so users can find "svn latest" or
"x.y-SNAPSHOT" and clearly distinguish this from the latest (and maybe
some previous) release(s).
Phil
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: [site]Sites for snapshots published
Posted by robert burrell donkin <ro...@blueyonder.co.uk>.
On Mon, 2006-05-22 at 20:45 +0200, Oliver Heger wrote:
> Hi,
>
> I just noticed that recently the sites of some components have been
> deployed directly from their svn trunk. So the sites refer to snapshot
> versions (e.g. BeanUtils, Configuration, Math, ...). Was this done by
> intension?
yep - i did it. i went through and changed siteAddress then redeployed
each site.
please feel free to jump in and redeploy anything that isn't right.
> It might be confusing for users if the sites describe features that are
> not contained in the latest releases.
IMHO it's a trade off. users get to see all the features that are
available but have to actively search for documentation related to the
version they have downloaded.
many components provide link to the released documentation (for example
http://jakarta.apache.org/commons/logging/) though it would probably be
a good idea to add an indication on the navigation bar that these
documents apply to the latest code...
- robert
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org