Skip to content
This repository was archived by the owner on Jul 29, 2024. It is now read-only.

Commit eb1d0fc

Browse files
committed
docs(release): Update release docs for 5.4 series.
1 parent 6c46098 commit eb1d0fc

File tree

1 file changed

+6
-26
lines changed

1 file changed

+6
-26
lines changed

release.md

+6-26
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,24 @@
1-
Protractor Release Checklist
2-
----------------------------
1+
Protractor Release Checklist (5.4 edition)
2+
------------------------------------------
33

4-
Say the previous release was 0.0.J, the current release is 0.0.K, and the next release will be 0.0.L.
4+
This branch is only for releases in the 5.4 series. This is the last version of Protractor that supports the WebDriver control flow, and is only compatible with Selenium version prior to Selenium 4.
55

6-
- Check that features and bug fixes are in by looking at the milestone tag for 0.0.K. Create a milestone for 0.0.L, and bump anything that doesn't need to be finished from 0.0.K to 0.0.L.
7-
8-
- Check if there are new versions of [selenium and iedriver](http://selenium-release.storage.googleapis.com/index.html), [chromedriver](http://chromedriver.storage.googleapis.com/index.html), or [latest browsers](https://saucelabs.com/platforms) that the configuration needs to be updated against. We test against the latest two versions of Chrome, Firefox, and IE.
9-
10-
- The latest selenium version should be used in spec/ciFullConf.js, spec/ciSmokeConf.js, and spec/ciNg2Conf.js.
11-
- The versions in config.json/webdriverVersions should be up to date, and you should run `webdriver-manager update` locally.
12-
- The latest version of Chrome and Firefox should be used in spec/ciFullConf.js and spec/ciNg2Conf.js. All other browsers we support should be listed in spec/ciSmokeConf.js.
13-
14-
- Make sure [Travis](https://travis-ci.org/angular/protractor/builds) is passing. Note that there is an 'allowed failures' section in Travis - make sure that all failures are known.
6+
If you need to do a release of Protractor 5, follow these steps:
157

168
- Make sure [CircleCI](https://circleci.com/gh/angular/protractor) is passing (this runs `npm test`)
179

1810
- Make sure .gitignore and .npmignore are updated with any new files that need to be ignored.
1911

20-
- Make sure that the website and doc generation still work. Doing so now, before you update the package.json or CHANGELOG.md, will save you a big headache.
21-
- Run `./scripts/generate-docs.sh HEAD` to generate the docs against the current commit.
22-
- We have to compile down to es5 to get dgeni to work. `generate-docs.sh` can handle some of this but you may have to make minor changes to the codebase/build infrastructure.
23-
- Run the unit and e2e tests for the website.
24-
25-
- Update package.json with a version bump. If the changes are only bug fixes, increment the patch (e.g. 0.0.5 -> 0.0.6), otherwise increment the minor version.
12+
- Update package.json with a version bump. The only releases from this branch should be bug fixes, so you should only be incrementing the patch version.
2613

2714
- Update CHANGELOG.md.
2815
- You can get a list of changes in the correct format by running
2916
```
3017
git log 0.0.J..HEAD --format="- ([%h](https://github.com/angular/protractor/commit/%H)) %n%w(100,2,2)%B" > /tmp/changes.txt
3118
```
32-
3319
- Create a new section in CHANGELOG.md and copy in features (`feat`), big dependency version updates (`deps`), bug fixes (`fix`), and breaking changes. No need to note chores or stylistic changes - the changelog should be primarily useful to someone using Protractor, not developing on it.
3420
35-
- Breaking changes should be in their own section and include before/after examples of how to fix code that needs to change.
21+
- You won't be adding any breaking changes to the changelog, since breaking changes aren't allowed for Protractor 5! If there's a breaking change, something has gone wrong.
3622
3723
- Make a commit with the API and package.json changes titled chore(release): version bump and changelog for 0.0.K.
3824
@@ -46,11 +32,5 @@ Say the previous release was 0.0.J, the current release is 0.0.K, and the next r
4632
4733
- NPM publish
4834
49-
- Update the website. Run `./scripts/generate-docs.sh`, then switch to the `gh-pages` branch, edit the commit message with `git commit --amend`, and push the new website.
50-
51-
- Run e2e test against the published website.
52-
5335
- Let people know
5436
- Have @ProtractorTest tweet about it
55-
56-
- Close the 0.0.K milestone

0 commit comments

Comments
 (0)