Initial repo layout

README.md

@@ -1,4 +1,46 @@
 # Shared Travis Configuration Imports
 
-This repository is managed by the [Package Maintenance Working Group](https://github.com/nodejs/package-maintenance), see [Governance](https://github.com/nodejs/package-maintenance/blob/master/Governance.md).
+- This repository is managed by the [Package Maintenance Working Group](https://github.com/nodejs/package-maintenance), see [Governance](https://github.com/nodejs/package-maintenance/blob/master/Governance.md).
+- Read more about [Shared Build Configurations in Travis CI](https://docs.travis-ci.com/user/build-config-imports/).
 
+## Usage
+
+Replace the list of `node_js` versions in your `.travis.yml` with one of the available files.
+
+### Examples
+
+#### `lts` policy: use LTS and current Node.js releases, starting with v10.x 
+
+```
+import:
+  - nodejs/ci-config-travis:lts/gte-10.yml
+```
+
+- Travis CI will use the latest version of each release line in the list
+- New major Node.js versions, greater or equal to v10.0.0, will be added to the list as soon as they are released
+- Once added, LTS versions will never be removed. Non-LTS versions will be removed when they reach their lifetime.
+    - Note that if your policy is to only support LTS versions, then removing the non-LTS version in your test matrix is not a breaking change, as the non-LTS version was never supported (it was only used for test purposes).
+
+
+#### `all` policy: use all Node.js releases, starting with v14.x 
+
+```
+import:
+  - nodejs/ci-config-travis:all/gte-14.yml
+```
+
+- Travis will use the latest version of each release line in the list
+- New major Node.js versions, greater or equal to v14.0.0, will be added to the list as soon as they are released
+- Once added, versions will never be removed from the list
+
+
+#### Strict `lts` policy: use only LTS Node.js releases, starting with v10.x 
+
+```
+import:
+  - nodejs/ci-config-travis:lts/strict/gte-10.yml
+```
+
+- Travis will use the latest version of each release line in the list
+- New major Node.js versions, greater or equal to v14.0.0, will be added to the list as soon as they achieve LTS status (i.e. ~6 months after they are released)
+- Once added, versions will never be removed from the list

all/gte-10.yml

@@ -0,0 +1,6 @@
+node_js:
+  - 14
+  - 13
+  - 12
+  - 11
+  - 10

all/gte-11.yml

@@ -0,0 +1,5 @@
+node_js:
+  - 14
+  - 13
+  - 12
+  - 11

all/gte-12.yml

@@ -0,0 +1,4 @@
+node_js:
+  - 14
+  - 13
+  - 12

all/gte-13.yml

@@ -0,0 +1,3 @@
+node_js:
+  - 14
+  - 13

all/gte-14.yml

@@ -0,0 +1,2 @@
+node_js:
+  - 14

all/gte-4.yml

@@ -0,0 +1,12 @@
+node_js:
+  - 14
+  - 13
+  - 12
+  - 11
+  - 10
+  - 9
+  - 8
+  - 7
+  - 6
+  - 5
+  - 4

all/gte-5.yml

@@ -0,0 +1,11 @@
+node_js:
+  - 14
+  - 13
+  - 12
+  - 11
+  - 10
+  - 9
+  - 8
+  - 7
+  - 6
+  - 5

all/gte-6.yml

@@ -0,0 +1,10 @@
+node_js:
+  - 14
+  - 13
+  - 12
+  - 11
+  - 10
+  - 9
+  - 8
+  - 7
+  - 6

all/gte-7.yml

@@ -0,0 +1,9 @@
+node_js:
+  - 14
+  - 13
+  - 12
+  - 11
+  - 10
+  - 9
+  - 8
+  - 7

all/gte-8.yml

@@ -0,0 +1,8 @@
+node_js:
+  - 14
+  - 13
+  - 12
+  - 11
+  - 10
+  - 9
+  - 8

all/gte-9.yml

@@ -0,0 +1,7 @@
+node_js:
+  - 14
+  - 13
+  - 12
+  - 11
+  - 10
+  - 9

lts/gte-10.yml

@@ -0,0 +1,4 @@
+node_js:
+  - 14
+  - 12
+  - 10

lts/gte-12.yml

@@ -0,0 +1,3 @@
+node_js:
+  - 14
+  - 12

lts/gte-14.yml

@@ -0,0 +1,2 @@
+node_js:
+  - 14

lts/gte-4.yml

@@ -0,0 +1,7 @@
+node_js:
+  - 14
+  - 12
+  - 10
+  - 8
+  - 6
+  - 4

lts/gte-6.yml

@@ -0,0 +1,6 @@
+node_js:
+  - 14
+  - 12
+  - 10
+  - 8
+  - 6

lts/gte-8.yml

@@ -0,0 +1,5 @@
+node_js:
+  - 14
+  - 12
+  - 10
+  - 8

lts/strict/gte-10.yml

@@ -0,0 +1,3 @@
+node_js:
+  - 12
+  - 10

lts/strict/gte-12.yml

@@ -0,0 +1,2 @@
+node_js:
+  - 12

lts/strict/gte-4.yml

@@ -0,0 +1,6 @@
+node_js:
+  - 12
+  - 10
+  - 8
+  - 6
+  - 4

lts/strict/gte-6.yml

@@ -0,0 +1,5 @@
+node_js:
+  - 12
+  - 10
+  - 8
+  - 6

lts/strict/gte-8.yml

@@ -0,0 +1,4 @@
+node_js:
+  - 12
+  - 10
+  - 8