You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@incubator.apache.org by Dave Fisher <da...@comcast.net> on 2019/02/28 18:37:36 UTC
Changes to Website and Marking As Obsolete SVN Version of Incubator
Website
Hi -
I’ve been reviewing the incubator’s svn repository. In order to avoid confusion I am going to add README.txt files to directories (eg. [1]) which are now obsolete, but not obviously so.
I’ve been doing so since there is no documentation on maintaining the content/podling/${podling}.yml files which are used by Whimsy to display licensing progress. I see now that in the git repos [2] that mentor.ad and website.ad will need to be updated.
I’m planning to look at this next week and am giving the community a heads up. If there are suggestions for these and other changes to these pages then let me know.
Regards,
Dave
[1] https://svn.apache.org/repos/asf/incubator/public/trunk/content/guides <https://svn.apache.org/repos/asf/incubator/public/trunk/content/guides>
[2] https://gitbox.apache.org/repos/asf?p=incubator.git;a=summary <https://gitbox.apache.org/repos/asf?p=incubator.git;a=summary>
Re: Changes to Website and Marking As Obsolete SVN Version of
Incubator Website
Posted by Greg Stein <gs...@gmail.com>.
On Tue, Mar 5, 2019 at 4:56 AM Bertrand Delacretaz <
bdelacretaz@codeconsult.ch> wrote:
> On Tue, Mar 5, 2019 at 10:04 AM Greg Stein <gs...@gmail.com> wrote:
> > ...So, rather than OBSOLETE, or multiple README, I advocate a single
> top-level
> > README that details the deletions/reasons. Then just do an svn rm...
>
> Works for me, the idea of OBSOLETE is to make it obvious that stuff
> has been deactivated but a clear README works as well.
>
> (erring on the safe side here as I'm not sure if anyone still has the
> overview on what's useful or not)
>
It's a reversible step. Any directory/file can be recovered from history.
No worries.
Re: Changes to Website and Marking As Obsolete SVN Version of
Incubator Website
Posted by Bertrand Delacretaz <bd...@codeconsult.ch>.
On Tue, Mar 5, 2019 at 10:04 AM Greg Stein <gs...@gmail.com> wrote:
> ...So, rather than OBSOLETE, or multiple README, I advocate a single top-level
> README that details the deletions/reasons. Then just do an svn rm...
Works for me, the idea of OBSOLETE is to make it obvious that stuff
has been deactivated but a clear README works as well.
(erring on the safe side here as I'm not sure if anyone still has the
overview on what's useful or not)
-Bertrand
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Changes to Website and Marking As Obsolete SVN Version of
Incubator Website
Posted by Greg Stein <gs...@gmail.com>.
On Mon, Mar 4, 2019 at 10:12 AM Bertrand Delacretaz <
bdelacretaz@codeconsult.ch> wrote:
> Hi Dave,
>
> On Thu, Feb 28, 2019 at 7:37 PM Dave Fisher <da...@comcast.net> wrote:
> > ...I’ve been reviewing the incubator’s svn repository. In order to avoid
> confusion I am going to
> > add README.txt files to directories (eg. [1]) which are now obsolete,
> but not obviously so....
>
> How about moving them under an OBSOLETE folder instead?
With Subversion, the content will always be there. Moving them to an
OBSOLETE folder is kinda silly. Just delete the stuff, so *current*
checkouts don't pick up the content.
A single, top-level README.txt indicating what "significant" directories
were removed, and in what revision ... now *that* would be helpful. It is
somewhat difficult to discover deleted directories in svn, even though
they're sitting right there in history. ... But a README can say "removed
../site/ in r$FOO because we moved our site content over to
$gitRepositoryURL"
So, rather than OBSOLETE, or multiple README, I advocate a single top-level
README that details the deletions/reasons. Then just do an svn rm.
Cheers,
-g
Re: Changes to Website and Marking As Obsolete SVN Version of
Incubator Website
Posted by Bertrand Delacretaz <bd...@codeconsult.ch>.
Hi Dave,
On Thu, Feb 28, 2019 at 7:37 PM Dave Fisher <da...@comcast.net> wrote:
> ...I’ve been reviewing the incubator’s svn repository. In order to avoid confusion I am going to
> add README.txt files to directories (eg. [1]) which are now obsolete, but not obviously so....
How about moving them under an OBSOLETE folder instead?
That would make things clearer - just make sure the website build at
https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20Site/
still works after that.
-Bertrand
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Changes to Website and Marking As Obsolete SVN Version of
Incubator Website
Posted by Lars Francke <la...@gmail.com>.
Yes please, thank you!
I asked about this a few weeks ago as this had me very confused!
<
https://lists.apache.org/thread.html/42cd652f4621d55d5de51c5e84b39c1677ef92310e6f626a3b794574@%3Cgeneral.incubator.apache.org%3E
>
On Thu, Feb 28, 2019 at 7:37 PM Dave Fisher <da...@comcast.net> wrote:
> Hi -
>
> I’ve been reviewing the incubator’s svn repository. In order to avoid
> confusion I am going to add README.txt files to directories (eg. [1]) which
> are now obsolete, but not obviously so.
>
> I’ve been doing so since there is no documentation on maintaining the
> content/podling/${podling}.yml files which are used by Whimsy to display
> licensing progress. I see now that in the git repos [2] that mentor.ad
> and website.ad will need to be updated.
>
> I’m planning to look at this next week and am giving the community a heads
> up. If there are suggestions for these and other changes to these pages
> then let me know.
>
> Regards,
> Dave
>
> [1] https://svn.apache.org/repos/asf/incubator/public/trunk/content/guides
> <https://svn.apache.org/repos/asf/incubator/public/trunk/content/guides>
> [2] https://gitbox.apache.org/repos/asf?p=incubator.git;a=summary <
> https://gitbox.apache.org/repos/asf?p=incubator.git;a=summary>
>
>