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:
parent
122c1186ba
commit
e0ce1fc446
|
@ -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.
|
|
@ -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.
|
||||||
|
|
|
@ -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": [
|
||||||
|
|
Loading…
Reference in New Issue