Skip to content

Commit 60ede5c

Browse files
committed
Add support statement
Fixes #1599
1 parent 4f896c2 commit 60ede5c

File tree

4 files changed

+19
-1
lines changed

4 files changed

+19
-1
lines changed

docs/support-statement.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
### Supported Node.js versions
2+
3+
AVA supports the latest release of any major version that [is supported by Node.js itself](https://github.com/nodejs/Release#release-schedule).
4+
5+
*Support* here means that we run our test suite under the given Node.js versions and will accept pull requests to fix any bugs (provided they're not known bugs in Node.js itself that will be fixed imminently). Consequently, *dropping support* means we'll remove those Node.js versions from our test matrix and will no longer accept specific pull requests to fix bugs under those versions.
6+
7+
When we drop support for an LTS-covered major version we will bump AVA's major version number (or, while we're in the `0.` phase, the minor version number).
8+
9+
We will drop support for odd-numbered Node.js versions (e.g. `7` or `9`) *without* bumping AVA's major version number.
10+
11+
We try to avoid *accidentally* dropping support for non-latest Node.js releases. If such breakage does occur we'll accept pull requests to restore functionality. We might decide to deprecate the offending AVA release and bump AVA's major version number instead.
12+
13+
We may explicitly drop support for non-latest Node.js releases. If this occurs we will bump AVA's major version number. This may be due to adoption of backported APIs or the availability of newer V8 releases in later Node.js versions, either in AVA itself or one of our dependencies.

maintaining.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ Read and adhere to the [Code of Conduct](code-of-conduct.md).
1818

1919
- Bump dependencies.
2020
- Ensure [Travis CI](https://travis-ci.org/avajs/ava) and [AppVeyor](https://ci.appveyor.com/project/avajs/ava/branch/master) are green.
21+
- If [necessary](docs/support-statement.md), update the `engines` field in `package.json`
2122
- Publish a new version using [`np`](https://github.com/sindresorhus/np) with a version number according to [semver](http://semver.org).
2223
- Write a [release note](https://github.com/avajs/ava/releases/new) following the style of previous release notes.
2324

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
"homepage": "https://ava.li",
88
"bin": "cli.js",
99
"engines": {
10-
"node": ">=4"
10+
"node": ">=4.8.7 <5 || >=6.12.3 <7 || >=8.9.4"
1111
},
1212
"scripts": {
1313
"lint": "xo && (cd test/fixture && xo '**' '!{source-map-initial,syntax-error}.js' '!snapshots/test-sourcemaps/build/**') && lock-verify",

readme.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -148,6 +148,10 @@ $ npm test -- --watch
148148

149149
AVA comes with an intelligent watch mode. [Learn more in its recipe](docs/recipes/watch-mode.md).
150150

151+
### Supported Node.js versions
152+
153+
AVA supports the latest release of any major version that [is supported by Node.js itself](https://github.com/nodejs/Release#release-schedule). Read more in our [support statement](docs/support-statement.md).
154+
151155
## CLI
152156

153157
```console

0 commit comments

Comments
 (0)