You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by Brett Porter <br...@apache.org> on 2010/03/23 03:43:33 UTC
removing old staging directories?
In the release docs [1], there is nothing about removing the staged documentation directory after it is completed. This means we have a lot of versioned directories of plugin sites, but they are never linked to. Should they be removed?
Perhaps it would be better if the staging was done to /www/people.apache.org/builds/maven/sites instead?
- Brett
--
Brett Porter
brett@apache.org
http://brettporter.wordpress.com/
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: removing old staging directories?
Posted by Brian Fox <br...@infinity.nu>.
Since they aren't linked anywhere, they are essentially invisible and
really only helpful to those few devs around here who know they exist.
(Those who really need them least)
2010/3/23 Barrie Treloar <ba...@gmail.com>:
> On Wed, Mar 24, 2010 at 10:41 AM, Wendy Smoak <ws...@gmail.com> wrote:
>>
>> On Tue, Mar 23, 2010 at 6:45 PM, Brett Porter <br...@apache.org> wrote:
>> > In what instances do you find you need to use them? I thought for plugins, with the use of @since and similar descriptive text it wasn't needed.
>>
>> Count me -0 on removing them. We keep versioned docs around for a lot
>> of things and I think they're useful, but I won't argue if others want
>> to get rid of them.
>>
>
> [1] wasn't linked to, is it
> http://maven.apache.org/developers/release/maven-plugin-release.html
> and the staged docs directory of
> /www/maven.apache.org/plugins/maven-XXX-plugin-Y.Z
>
> If we have the disk space I'd prefer to keep them around.
> I've visited specific older versions enough that they are handy.
> But I can see that having really old stuff around isn't adding value.
> I guess in the worst case you can grab the source and regenerate the
> site yourself.
>
> Which I guess means I'd vote -0 as well.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: removing old staging directories?
Posted by Barrie Treloar <ba...@gmail.com>.
On Wed, Mar 24, 2010 at 10:41 AM, Wendy Smoak <ws...@gmail.com> wrote:
>
> On Tue, Mar 23, 2010 at 6:45 PM, Brett Porter <br...@apache.org> wrote:
> > In what instances do you find you need to use them? I thought for plugins, with the use of @since and similar descriptive text it wasn't needed.
>
> Count me -0 on removing them. We keep versioned docs around for a lot
> of things and I think they're useful, but I won't argue if others want
> to get rid of them.
>
[1] wasn't linked to, is it
http://maven.apache.org/developers/release/maven-plugin-release.html
and the staged docs directory of
/www/maven.apache.org/plugins/maven-XXX-plugin-Y.Z
If we have the disk space I'd prefer to keep them around.
I've visited specific older versions enough that they are handy.
But I can see that having really old stuff around isn't adding value.
I guess in the worst case you can grab the source and regenerate the
site yourself.
Which I guess means I'd vote -0 as well.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: removing old staging directories?
Posted by Wendy Smoak <ws...@gmail.com>.
On Tue, Mar 23, 2010 at 6:45 PM, Brett Porter <br...@apache.org> wrote:
> In what instances do you find you need to use them? I thought for plugins, with the use of @since and similar descriptive text it wasn't needed.
Count me -0 on removing them. We keep versioned docs around for a lot
of things and I think they're useful, but I won't argue if others want
to get rid of them.
--
Wendy
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: removing old staging directories?
Posted by Brett Porter <br...@apache.org>.
On 24/03/2010, at 5:43 AM, Wendy Smoak wrote:
> On Mon, Mar 22, 2010 at 10:43 PM, Brett Porter <br...@apache.org> wrote:
>> In the release docs [1], there is nothing about removing the staged documentation directory after it is completed. This means we have a lot of versioned directories of plugin sites, but they are never linked to. Should they be removed?
>
> No. People don't always use the latest release of every plugin, it's
> very useful to have the exact docs for your version available so you
> can see what options there are.
>
> There was some discussion of linking to them, probably two years ago
> or whenever we started doing this, but we never decided how to do it.
> I was hesitant to add another task to the RM's already long list. :(
>
> I use those docs, but I "just know" where they are. They are official
> docs IMO, not really "staged" (even though that's how they get there,
> I subverted the staging url to avoid changing the config that was
> already in the poms.)
In what instances do you find you need to use them? I thought for plugins, with the use of @since and similar descriptive text it wasn't needed.
- Brett
--
Brett Porter
brett@apache.org
http://brettporter.wordpress.com/
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: removing old staging directories?
Posted by Wendy Smoak <ws...@gmail.com>.
On Mon, Mar 22, 2010 at 10:43 PM, Brett Porter <br...@apache.org> wrote:
> In the release docs [1], there is nothing about removing the staged documentation directory after it is completed. This means we have a lot of versioned directories of plugin sites, but they are never linked to. Should they be removed?
No. People don't always use the latest release of every plugin, it's
very useful to have the exact docs for your version available so you
can see what options there are.
There was some discussion of linking to them, probably two years ago
or whenever we started doing this, but we never decided how to do it.
I was hesitant to add another task to the RM's already long list. :(
I use those docs, but I "just know" where they are. They are official
docs IMO, not really "staged" (even though that's how they get there,
I subverted the staging url to avoid changing the config that was
already in the poms.)
--
Wendy
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: removing old staging directories?
Posted by Dennis Lundberg <de...@apache.org>.
On 2010-03-23 03:43, Brett Porter wrote:
> In the release docs [1], there is nothing about removing the staged documentation directory after it is completed. This means we have a lot of versioned directories of plugin sites, but they are never linked to. Should they be removed?
+1
> Perhaps it would be better if the staging was done to /www/people.apache.org/builds/maven/sites instead?
+1
>
> - Brett
>
> --
> Brett Porter
> brett@apache.org
> http://brettporter.wordpress.com/
>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>
--
Dennis Lundberg
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: removing old staging directories?
Posted by Olivier Lamy <ol...@apache.org>.
2010/3/23 Brett Porter <br...@apache.org>:
> In the release docs [1], there is nothing about removing the staged documentation directory after it is completed. This means we have a lot of versioned directories of plugin sites, but they are never linked to. Should they be removed?
IMHO yes
>
> Perhaps it would be better if the staging was done to /www/people.apache.org/builds/maven/sites instead?
+1 (cleanup will be easier)
>
> - Brett
>
> --
> Brett Porter
> brett@apache.org
> http://brettporter.wordpress.com/
>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>
--
Olivier
http://twitter.com/olamy
http://fr.linkedin.com/in/olamy
http://www.viadeo.com/fr/profile/olivier.lamy7
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org