uima-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Richard Eckart de Castilho <...@apache.org>
Subject Re: [jira] [Created] (UIMA-5874) Archiving old releases
Date Mon, 01 Oct 2018 15:16:15 GMT
On 1. Oct 2018, at 15:36, Marshall Schor <msa@schor.com> wrote:
> 
> It's true, that with some work, one could download archive dists and unpack
> them, and get these artifacts, but I thought that since we've already done that
> and they are already in SVN, why not keep a semi-convenient way to get to these,
> for our users who might still be using an older release?

The latest documentation should always be accessible by the "[product]-current" URLs
which can be hard-coded on the documentations page (i.e. no change to the uima-site necessary
here when a release is performed)

https://svn.apache.org/repos/asf/uima/site/trunk/uima-website/docs/d/uimaj-current/index.html
https://svn.apache.org/repos/asf/uima/site/trunk/uima-website/docs/d/uimafit-current/tools.uimafit.book.html
... etc.

The "[product]-current" folders are created via a "svn copy" command after checking in the
docs for 
a new release.

We could avoid having all the old docs checked out whenever we want to edit the site by moving
the whole "docs/d" folder e.g. to "site/archive" and including a link to

  https://svn.apache.org/repos/asf/uima/site/archive/site/archive/docs/d

on the downloads and/or documentation page to point to old versions.

Since the website is in SVN, the user can conveniently browse the tree
and access the HTML files (e.g. APIDocs) inside it.

We'd then only retain the "[product]-current" ones under "uima/site/trunk/uima-website/docs/d".

I think we don't need to tag the entire website just to archive the old docs.

Cheers,

-- Richard


Mime
View raw message