Start development of 3.0

- Update version number in package.json, publish under "next" tag
 - Add 3.0-DEVELOPING.md describing the process
 - Add 3.0-RELEASE-NOTES.md to incrementally build release docs
This commit is contained in:
Miroslav Bajtoš 2015-12-22 09:43:09 +01:00
parent 122c1186ba
commit e0ce1fc446
3 changed files with 46 additions and 1 deletions

38
3.0-DEVELOPING.md Normal file
View File

@ -0,0 +1,38 @@
# How to develop LoopBack 3.0
## Keeping track of major and breaking changes
We will need a detailed release notes for 3.0. To make our life easier, we
should build them incrementally in a file called `3.0-RELEASE-NOTES.md`.
Each pull request containing a major change must include an update
of this file describing the change for a user upgrading from 2.x to 3.0.
## Branch setup
Most patches should be landed on the master branch, the new 3.0 release
will be eventually released from master too.
It is up to the discretion of reviewers to decide which changes to
back-port from master to 2.x. Initially, we should probably land all bug fixes
and most backwards-compatible enhancements. This rule should be revisited
once 3.0.0 was released.
## Publishing pre-release versions
To make it easy for LB developers to test out the upcoming 3.0 version, we
should regularly publish pre-release versions to npmjs. However, extra care
must be taken to ensure "npm install" keeps downloading the current 2.x series.
When 2.x branch was created, we have changed package.json on the *master*
branch and
1. changed the version string to `"3.0.0-alpha.1"`
2. added the following bit: `"publishConfig": { "tag": "next" }`
Whenever making a new pre-release version, increment the latest number:
`3.0.0-alpha.2`, `3.0.0-alpha.3`, etc. Once get closer to the release date,
we can release `3.0.0-beta.1`, possibly also `3.0.0-rc.1`.
The benefit of this version scheme is that module consumers can use carrot
operator to get automatic updates: `"^3.0.0-alpha.1"` matches all versions
from the previous paragraph.

6
3.0-RELEASE-NOTES.md Normal file
View File

@ -0,0 +1,6 @@
# List of notable changes made between 2.x and 3.0
All breaking changes must be described here. When adding a new entry,
always describe the impact on users and instructions for upgrading
applications from 2.x to 3.0.

View File

@ -1,6 +1,7 @@
{ {
"name": "loopback", "name": "loopback",
"version": "2.26.2", "version": "3.0.0-alpha.1",
"pubishConfig": { "tag": "next" },
"description": "LoopBack: Open Source Framework for Node.js", "description": "LoopBack: Open Source Framework for Node.js",
"homepage": "http://loopback.io", "homepage": "http://loopback.io",
"keywords": [ "keywords": [