summaryrefslogtreecommitdiff
path: root/doc/api/documentation.md
diff options
context:
space:
mode:
authorRich Trott <rtrott@gmail.com>2018-08-26 18:30:48 -0700
committerGeorge Adams <george.adams@uk.ibm.com>2018-08-30 20:15:40 +0100
commita0b5e6dbfdbc0094d5c73269b36470944b771464 (patch)
tree708b1efeb91382183c6ce37f7f4b698912cffaee /doc/api/documentation.md
parent503fd55a35ce056d636c15811c07b51126af271a (diff)
downloadandroid-node-v8-a0b5e6dbfdbc0094d5c73269b36470944b771464.tar.gz
android-node-v8-a0b5e6dbfdbc0094d5c73269b36470944b771464.tar.bz2
android-node-v8-a0b5e6dbfdbc0094d5c73269b36470944b771464.zip
doc: make Stability Index more concise
Shorten the Stability Index text. PR-URL: https://github.com/nodejs/node/pull/22544 Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com> Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com> Reviewed-By: Minwoo Jung <minwoo@nodesource.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Tobias Nießen <tniessen@tnie.de> Reviewed-By: James M Snell <jasnell@gmail.com>
Diffstat (limited to 'doc/api/documentation.md')
-rw-r--r--doc/api/documentation.md19
1 files changed, 8 insertions, 11 deletions
diff --git a/doc/api/documentation.md b/doc/api/documentation.md
index f9fa9591af..afad0e653e 100644
--- a/doc/api/documentation.md
+++ b/doc/api/documentation.md
@@ -34,24 +34,21 @@ and in the process of being redesigned.
The stability indices are as follows:
-> Stability: 0 - Deprecated. This feature is known to be problematic, and
-> changes may be planned. Do not rely on it. Use of the feature may cause
-> warnings to be emitted. Backwards compatibility across major versions should
-> not be expected.
+> Stability: 0 - Deprecated. The feature may emit warnings. Backward
+> compatibility is not guaranteed.
<!-- separator -->
> Stability: 1 - Experimental. This feature is still under active development
-> and subject to non-backwards compatible changes, or even removal, in any
-> future version. Use of the feature is not recommended in production
-> environments. Experimental features are not subject to the Node.js Semantic
-> Versioning model.
+> and subject to non-backward compatible changes or removal in any future
+> version. Use of the feature is not recommended in production environments.
+> Experimental features are not subject to the Node.js Semantic Versioning
+> model.
<!-- separator -->
-> Stability: 2 - Stable. The API has proven satisfactory. Compatibility with the
-> npm ecosystem is a high priority, and will not be broken unless absolutely
-> necessary.
+> Stability: 2 - Stable. Compatibility with the npm ecosystem is a high
+> priority.
Caution must be used when making use of `Experimental` features, particularly
within modules that may be used as dependencies (or dependencies of