Good questions!

Here's how the uima website publishing works:
The website works by having a hook that watches for svn commits to the
.../uima/site/trunk/uima-website/docs/ folder, which it copies to the website
when svn changes.

Moving things to an archive spot that was still accessible by the website could
be done, just by moving things to another svn spot, not under the watchful eye
of the above hook. You can still refer to those spots using the http interface
to the svn, say something like:
https://svn.apache.org/repos/asf/uima/site/trunk/uima-website-archive/x/y/z etc.

It would be important that these be lightly loaded links, I think; and this is
likely the case for older archived releases.

Doing this would reduce the MB consumed on the apache site web server.  This is
(occasionally) a goal, although I haven't heard any complaints from Infra about
this recently - maybe disk space is not an issue anymore.

Another goal is to reduce the download size when checking out the uima-website
for maintenance. By having the archived stuff be under
.../uima/site/trunk/uima-website-archive instead of .../uima-website, we remove
the extra stuff from the normal maintenance download footprint of the website.

Moving the items under docs/d might break url links;  this can be mitigated by
using the "current" symbolic link, as several projects already are doing.

-Marshall

On 3/30/2017 3:52 AM, Richard Eckart de Castilho wrote:

> Hi,
>
> hm...
>
> $ du -sh uima-website
> 1,3G  uima-website
>
> $ du -sh *
> 4,0K  HOWTO
> 8,0K  build-ip-clearances.xml
> 8,0K  build.xml
> 710M  docs
> 888K  lib
> 152K  velocity.log
>  23M  xdocs
>
> I agree: at some point we should consider what to do with the old docs.
>
> How does the UIMA website work? Could we have a separte folder in SVN that
> is served via the webserver but that would not be part of the site that we
> check out and update on a regular basis?
>
> -- Richard
>
>> On 29.03.2017, at 16:36, Marshall Schor <[email protected]> wrote:
>>
>> Hi,
>>
>>
>> From time to time (in the past at least) we have been asked to "delete" 
>> things
>> off of the uima website to make it smaller.
>>
>> The main size consumers on the website are the docs/d/ folders - there's one 
>> per
>> (somewhat recent) release.
>>
>> Since transitioning to the svn way of publishing, it strikes me that we could
>> shrink our website footprint by taking advantage of the svn storage, 
>> something
>> like this:
>>
>> 1) For older release, unlikely to be referenced frequently if at all, delete
>> them.  They will disappear from svn "HEAD", but still be there in older 
>> revisions.
>>
>> 2) put up a new page (archived docs) which provides instructions on how to 
>> find
>> the older versions in
>> https://svn.apache.org/repos/asf/uima/site/trunk/uima-website/docs/d/ etc.
>>
>> (optionally), we could put in hyperlinks to the svn revision having the top
>> folder in the viewsvn api style.
>>
>> Is this worth doing?
>>
>>
>> Any volunteers :-) ?
>>
>> -Marshall

Reply via email to