From 6a17abc7652e2fe563e1288c6e8c23fc260dda97 Mon Sep 17 00:00:00 2001 From: "Benjamin E. Coe" Date: Mon, 23 Mar 2020 19:22:34 -0700 Subject: [PATCH] docs: document the release schedule we follow (#454) --- .../gcp/templates/node_library/README.md | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/synthtool/gcp/templates/node_library/README.md b/synthtool/gcp/templates/node_library/README.md index bf3e80dee..fd15eeb03 100644 --- a/synthtool/gcp/templates/node_library/README.md +++ b/synthtool/gcp/templates/node_library/README.md @@ -84,6 +84,27 @@ has instructions for running the samples. The [{{ metadata['repo']['name_pretty'] }} {{ metadata['repo']['language']|language_pretty }} Client API Reference][client-docs] documentation also contains samples. {% endif %} +## Supported Node.js Versions + +Our client libraries follow the [Node.js release schedule](https://nodejs.org/en/about/releases/). +Libraries are compatible with all current _active_ and _maintenance_ versions of +Node.js. + +Client libraries targetting some end-of-life versions of Node.js are available, and +can be installed via npm [dist-tags](https://docs.npmjs.com/cli/dist-tag). +The dist-tags follow the naming convention `legacy-(version)`. + +_Legacy Node.js versions are supported as a best effort:_ + +* Legacy versions will not be tested in continuous integration. +* Some security patches may not be able to be backported. +* Dependencies will not be kept up-to-date, and features will not be backported. + +#### Legacy tags available + +* `legacy-8`: install client libraries from this dist-tag for versions + compatible with Node.js 8. + ## Versioning This library follows [Semantic Versioning](http://semver.org/).