From 301e78b1b8f9b96b51c078b9bc59acc81c9debb8 Mon Sep 17 00:00:00 2001 From: Dave Whiteland Date: Thu, 3 Jul 2014 14:49:29 +0100 Subject: explicit use of 'tag' now when referring to releases --- docs/glossary.md | 15 ++++++++------- docs/running/upgrading.md | 14 ++++++++------ 2 files changed, 16 insertions(+), 13 deletions(-) (limited to 'docs') diff --git a/docs/glossary.md b/docs/glossary.md index 7a7c5d003..d35454cbf 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -510,12 +510,12 @@ Definitions
We issue new releases of the Alaveteli code whenever key work (new features, improvements, bugfixes, and so on) have been added to - the core code. Releases are identified by three numbers: major, minor, and - — if necessary — a patch number. We recommend you always use - the latest version. The process is handled by the Alaveteli release - manager, who decides what changes are to be included in the - current release, and the cut-off date for the work. Currently this is - Alaveteli's lead developer at mySociety. + the core code. Releases are identified by their tag, which comprises two or + three numbers: major, minor, and — if necessary — a patch + number. We recommend you always use the latest version. The process is + handled by the Alaveteli release manager, who decides what + changes are to be included in the current release, and the cut-off date for + the work. Currently this is Alaveteli's lead developer at mySociety.

More information:

    @@ -524,7 +524,8 @@ Definitions master branch.
  • - See a list of all releases. + See a list of all releases + and their explicit tags.
  • We try to coordinate releases with any active translation work too. diff --git a/docs/running/upgrading.md b/docs/running/upgrading.md index 611712bf6..2142bfd47 100644 --- a/docs/running/upgrading.md +++ b/docs/running/upgrading.md @@ -7,8 +7,9 @@ Upgrading Alaveteli

    Alaveteli is under active development — don't let the - version you're running get too far behind our latest release. This page - describes how to keep your site up-to-date + version you're running get too far behind our latest + release. + This page describes how to keep your site up-to-date

    ## Master branch contains the latest stable release @@ -16,9 +17,10 @@ Upgrading Alaveteli The developer team policy is that the `master` branch in git should always contain the latest stable release -- so you'll be up to date if you pull from the `master` branch. However, on your -production site, -you should know precisely what version you're running, and deploy Alaveteli -from a [*specific* release tag](https://github.com/mysociety/alaveteli/releases). +production +site, you should know precisely what version you're running, and deploy +Alaveteli from a [*specific* release +tag](https://github.com/mysociety/alaveteli/releases). Upgrading may just require pulling in the latest code -- but it may also require other changes ("further action"). For this reason, for anything other than a @@ -32,7 +34,7 @@ other changes that might be needed to make the new code work. * If you're using Capistrano for deployment, simply [deploy the code]({{site.baseurl}}docs/installing/deploy/#usage): set the repo and branch in `deploy.yml` to be the version you want. - We recommend you set this to the explicit branch name (for example, + We recommend you set this to the explicit tag name (for example, `0.18`, and not `master`) so there's no risk of you accidentally deploying a new version before you're aware it's been released. * otherwise, you can simply upgrade by running `git pull` -- cgit v1.2.3