From 11864096463cd8cbcb2199c7b7d1019c5dc7449a Mon Sep 17 00:00:00 2001
From: Ben Mosher <me@benmosher.com>
Date: Wed, 2 Nov 2016 05:25:25 -0400
Subject: [PATCH] first draft of release steps in `RELEASE.md`

---
 RELEASE.md | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 RELEASE.md

diff --git a/RELEASE.md b/RELEASE.md
new file mode 100644
index 000000000..fa14a18f5
--- /dev/null
+++ b/RELEASE.md
@@ -0,0 +1,55 @@
+# Release steps
+
+1. create a `release-[x.y.z]` branch from tip of `master` (or whatever release commit)
+
+   ```bash
+   git checkout master && git pull && git checkout -b release-2.1.0
+   ```
+
+2. bump `package.json` + update CHANGELOG version links for all releasing packages (i.e., root + any resolvers)
+
+   In changelog for core plugin, normally leave [Unreleased] but update its link at the bottom
+   to be rooted at the new version's tag, and add a link for the new version rooted
+   at last version's tag.
+
+   ```markdown
+   [Unreleased]: https://github.com/benmosher/eslint-plugin-import/compare/v2.0.1...HEAD
+   [2.0.1]: https://github.com/benmosher/eslint-plugin-import/compare/v2.0.0...v2.0.1
+   ```
+
+   becomes
+
+   ```markdown
+   [Unreleased]: https://github.com/benmosher/eslint-plugin-import/compare/v2.1.0...HEAD
+   [2.1.0]: https://github.com/benmosher/eslint-plugin-import/compare/v2.0.1...v2.1.0
+   [2.0.1]: https://github.com/benmosher/eslint-plugin-import/compare/v2.0.0...v2.0.1
+   ```
+
+   Generally, don't use `npm version` for this because it creates a tag, which I normally
+   wait until signoff from all contributors (`new Set(["@jfmengels"])`) and actually
+   `npm publish`-ing to snap the tag.
+
+3. create pull request from `release-[x.y.z]` into `release` branch
+
+   I like this because it
+   - lists all commits in the release
+   - provides a commentary location to discuss the release
+   - builds in CI and provides test results
+
+4. iterate on feedback
+   - handle other issues
+   - merge more PRs
+   - fix issues in changelog/docs
+
+5. `npm publish` from `release-[x.y.z]` branch
+   - don't forget resolvers!
+
+6. tag commit (`v[x.y.z]`)
+   - again, not forgetting resolvers, if needed (`resolvers/[name]/v[t.u.v]`)
+
+7. merge `release-[x.y.z]` into `release` (
+   - ideally fast-forward, probably with Git CLI instead of Github
+
+8. merge `release` into `master`
+
+Done!