diff options
author | Paulino Michelazzo <paulino@michelazzo.com.br> | 2016-10-18 22:48:23 +0200 |
---|---|---|
committer | Paulino Michelazzo <paulino@michelazzo.com.br> | 2016-10-18 22:48:23 +0200 |
commit | 99731f0bb1f6fd2815eeb9af504ce86df927657b (patch) | |
tree | b080efc608d2bbd52b77a4a0067402007f50c5a8 /RELEASE_PROCESS.md | |
parent | 3a3c6b866b52721431bed22426d9abfcd0d2dfe0 (diff) | |
parent | 7180aaed45dce62e40620a9e4b202526ebd6a3bb (diff) | |
download | wallabag-99731f0bb1f6fd2815eeb9af504ce86df927657b.tar.gz wallabag-99731f0bb1f6fd2815eeb9af504ce86df927657b.tar.zst wallabag-99731f0bb1f6fd2815eeb9af504ce86df927657b.zip |
Merge remote-tracking branch 'wallabag/master'
Diffstat (limited to 'RELEASE_PROCESS.md')
-rw-r--r-- | RELEASE_PROCESS.md | 36 |
1 files changed, 17 insertions, 19 deletions
diff --git a/RELEASE_PROCESS.md b/RELEASE_PROCESS.md index 45e60546..34e9a36f 100644 --- a/RELEASE_PROCESS.md +++ b/RELEASE_PROCESS.md | |||
@@ -1,47 +1,45 @@ | |||
1 | ## Definition | 1 | ## Definition |
2 | 2 | ||
3 | A release is mostly a git tag of http://github.com/wallabag/wallabag, following [semantic versioning](http://semver.org). | 3 | A release is mostly a git tag of http://github.com/wallabag/wallabag, following [semantic versioning](http://semver.org). |
4 | The last release at the time of writing is 2.0.0-alpha.2, from the v2 branch. | ||
5 | 4 | ||
6 | ### Steps to release | 5 | ### Steps to release |
7 | 6 | ||
8 | During this documentation, we assume the release is `release-2.0.0-beta.1`. | 7 | During this documentation, we assume the release is `$LAST_WALLABAG_RELEASE`. |
9 | 8 | ||
10 | #### Files to edit | 9 | #### Files to edit |
11 | 10 | ||
12 | - `app/config/config.yml` (`wallabag_core.version`) | 11 | - `app/config/config.yml` (`wallabag_core.version`) |
13 | - `README.md` (`composer create-project` command) | 12 | - `CHANGELOG.md` (by using this command `github_changelog_generator --no-compare-link --header-label="# Changelog" --no-issues --no-pr-wo-labels --since-tag="1.9.2"`. [github-changelog-generator is available here](https://github.com/skywinder/github-changelog-generator)) |
14 | - `docs/en/user/installation.rst` and its translations (`composer create-project` command) | ||
15 | 13 | ||
16 | #### Create release on GitHub | 14 | #### Create release on GitHub |
17 | 15 | ||
18 | - Run these commands to create the tag: | 16 | - Run these commands to create the tag: |
19 | 17 | ||
20 | ``` | 18 | ``` |
21 | git checkout v2 | 19 | git checkout master |
22 | git pull origin v2 | 20 | git pull origin master |
23 | git checkout -b release-2.0.0-beta.1 | 21 | git checkout -b release-$LAST_WALLABAG_RELEASE |
24 | SYMFONY_ENV=prod composer up --no-dev | 22 | SYMFONY_ENV=prod composer up --no-dev |
25 | git add --force composer.lock | 23 | git add --force composer.lock |
26 | git add README.md | 24 | git commit -m "Release wallabag $LAST_WALLABAG_RELEASE" |
27 | git commit -m "Release wallabag 2.0.0-beta.1" | 25 | git push origin release-$LAST_WALLABAG_RELEASE |
28 | git push origin release-2.0.0-beta.1 | ||
29 | ``` | 26 | ``` |
30 | 27 | ||
31 | - Create a new pull request with this title `DON'T MERGE Release wallabag 2.0.0-beta.1`. This pull request is used to launch builds on Travis-CI. | 28 | - Create a new pull request with this title `DON'T MERGE Release wallabag $LAST_WALLABAG_RELEASE`. This pull request is used to launch builds on Travis-CI. |
32 | - Run these commands to create the package: | 29 | - Run these command to create the package: |
33 | 30 | ||
34 | ``` | 31 | ``` |
35 | git clone git@github.com:wallabag/wallabag.git -b release-2.0.0-beta.1 release-2.0.0-beta.1 | 32 | make release master /tmp wllbg-release prod |
36 | SYMFONY_ENV=prod composer up -d=release-2.0.0-beta.1 --no-dev | ||
37 | tar czf wallabag-release-2.0.0-beta.1.tar.gz --exclude="var/*" --exclude=".git" release-2.0.0-beta.1 | ||
38 | ``` | 33 | ``` |
39 | 34 | ||
40 | - [Create the new release on GitHub](https://github.com/wallabag/wallabag/releases/new). You have to upload on this page the package. | 35 | - [Create the new release on GitHub](https://github.com/wallabag/wallabag/releases/new). You have to upload on this page the package. |
41 | - Delete the `release-2.0.0-beta.1` branch and close the pull request (**DO NOT MERGE IT**). | 36 | - Delete the `release-$LAST_WALLABAG_RELEASE` branch and close the pull request (**DO NOT MERGE IT**). |
42 | - Update the URL shortener (used on `wllbg.org` to generate links like `http://wllbg.org/latest-v2-package` or `http://wllbg.org/latest-v2`) | 37 | - Update the URL shortener (used on `wllbg.org` to generate links like `http://wllbg.org/latest-v2-package` or `http://wllbg.org/latest-v2`) |
43 | - Update [the downloads page](https://github.com/wallabag/wallabag.org/blob/master/content/pages/download.md) on the website (MD5 sum, release date) | 38 | - Update [the downloads page](https://github.com/wallabag/wallabag.org/blob/master/content/pages/download.md) on the website (MD5 sum, release date) |
44 | - Drink a beer! | 39 | - Update Dockerfile https://github.com/wallabag/docker (and create a new tag) |
40 | - Update wallabag.org website (downloads, releases and new blog post) | ||
41 | - Put the next patch version suffixed with `-dev` in `app/config/config.yml` (`wallabag_core.version`) | ||
42 | - Drink a :beer:! | ||
45 | 43 | ||
46 | ### `composer.lock` | 44 | ### `composer.lock` |
47 | A release tag must contain a `composer.lock` file. It sets which dependencies were available at the time a release was done, | 45 | A release tag must contain a `composer.lock` file. It sets which dependencies were available at the time a release was done, |