doc: update stability index

This simplifies the stability index to 4 levels: 0 - deprecated 1 - experimental / feature-flagged 2 - stable 3 - locked Domains has been downgraded to deprecated, assert has been downgraded to stable. Timers and Module remain locked. All other APIs are now stable. PR-URL: https://github.com/iojs/io.js/pull/943 Fixes: https://github.com/iojs/io.js/issues/930 Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Jeremiah Senkpiel <fishrock123@rocketmail.com> Reviewed-By: Vladimir Kurchatkin <vladimir.kurchatkin@gmail.com>
10 years ago · cf0306cd71
35 changed files with 42 additions and 65 deletions
--- a/doc/api/assert.markdown
+++ b/doc/api/assert.markdown
@ -1,6 +1,6 @@
 # Assert
-    Stability: 5 - Locked
+    Stability: 2 - Stable
 This module is used for writing unit tests for your applications, you can
 access it with `require('assert')`.
--- a/doc/api/buffer.markdown
+++ b/doc/api/buffer.markdown
@ -1,6 +1,6 @@
 # Buffer
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 Pure JavaScript is Unicode friendly but not nice to binary data.  When
 dealing with TCP streams or the file system, it's necessary to handle octet
--- a/doc/api/child_process.markdown
+++ b/doc/api/child_process.markdown
@ -1,6 +1,6 @@
 # Child Process
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 io.js provides a tri-directional `popen(3)` facility through the
 `child_process` module.
--- a/doc/api/cluster.markdown
+++ b/doc/api/cluster.markdown
@ -1,6 +1,6 @@
 # Cluster
-    Stability: 2 - Unstable
+    Stability: 2 - Stable
 A single instance of io.js runs in a single thread. To take advantage of
 multi-core systems the user will sometimes want to launch a cluster of io.js
--- a/doc/api/console.markdown
+++ b/doc/api/console.markdown
@ -1,6 +1,6 @@
 # console
-    Stability: 4 - API Frozen
+    Stability: 2 - Stable
 * {Object}
--- a/doc/api/crypto.markdown
+++ b/doc/api/crypto.markdown
@ -1,7 +1,6 @@
 # Crypto
-    Stability: 2 - Unstable; API changes are being discussed for
+    Stability: 2 - Stable
    future versions.  Breaking changes will be minimized.  See below.
 Use `require('crypto')` to access this module.
--- a/doc/api/debugger.markdown
+++ b/doc/api/debugger.markdown
@ -1,6 +1,6 @@
 # Debugger
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 <!-- type=misc -->
--- a/doc/api/dgram.markdown
+++ b/doc/api/dgram.markdown
@ -1,6 +1,6 @@
 # UDP / Datagram Sockets
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 <!-- name=dgram -->
--- a/doc/api/dns.markdown
+++ b/doc/api/dns.markdown
@ -1,6 +1,6 @@
 # DNS
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 Use `require('dns')` to access this module.
--- a/doc/api/documentation.markdown
+++ b/doc/api/documentation.markdown
@ -42,34 +42,20 @@ compatibility should not be expected.
 ```
 Stability: 1 - Experimental
-This feature was introduced recently, and may change
+This feature is subject to change, and is gated by a command line flag.
-or be removed in future versions.  Please try it out and provide feedback.
+It may change or be removed in future versions.
 If it addresses a use-case that is important to you, tell the node core team.
 ```
 ```
-Stability: 2 - Unstable
+Stability: 2 - Stable
-The API is in the process of settling, but has not yet had
+The API has proven satisfactory. Compatibility with the npm ecosystem
-sufficient real-world testing to be considered stable. Backwards-compatibility
+is a high priority, and will not be broken unless absolutely necessary.
 will be maintained if reasonable.
 ```
 ```
-Stability: 3 - Stable
+Stability: 3 - Locked
-The API has proven satisfactory, but cleanup in the underlying
+Only fixes related to security, performance, or bug fixes will be accepted.
-code may cause minor changes.  Backwards-compatibility is guaranteed.
+Please do not suggest API changes in this area; they will be refused.
 ```
 ```
 Stability: 4 - API Frozen
 This API has been tested extensively in production and is
 unlikely to ever have to change.
 ```
 ```
 Stability: 5 - Locked
 Unless serious bugs are found, this code will not ever
 change.  Please do not suggest changes in this area; they will be refused.
 ```
 ## JSON Output
--- a/doc/api/domain.markdown
+++ b/doc/api/domain.markdown
@ -1,6 +1,6 @@
 # Domain
-    Stability: 2 - Unstable
+    Stability: 0 - Deprecated
 **This module is pending deprecation**. Once a replacement API has been
 finalized, this module will be fully deprecated. Most end users should
--- a/doc/api/events.markdown
+++ b/doc/api/events.markdown
@ -1,6 +1,6 @@
 # Events
-    Stability: 4 - API Frozen
+    Stability: 2 - Stable
 <!--type=module-->
--- a/doc/api/fs.markdown
+++ b/doc/api/fs.markdown
@ -1,6 +1,6 @@
 # File System
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 <!--name=fs-->
--- a/doc/api/http.markdown
+++ b/doc/api/http.markdown
@ -1,6 +1,6 @@
 # HTTP
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 To use the HTTP server and client one must `require('http')`.
--- a/doc/api/https.markdown
+++ b/doc/api/https.markdown
@ -1,6 +1,6 @@
 # HTTPS
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 HTTPS is the HTTP protocol over TLS/SSL. In io.js this is implemented as a
 separate module.
--- a/doc/api/modules.markdown
+++ b/doc/api/modules.markdown
@ -1,6 +1,6 @@
 # Modules
-    Stability: 5 - Locked
+    Stability: 3 - Locked
 <!--name=module-->
--- a/doc/api/net.markdown
+++ b/doc/api/net.markdown
@ -1,6 +1,6 @@
 # net
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 The `net` module provides you with an asynchronous network wrapper. It contains
 methods for creating both servers and clients (called streams). You can include
--- a/doc/api/os.markdown
+++ b/doc/api/os.markdown
@ -1,6 +1,6 @@
 # OS
-    Stability: 4 - API Frozen
+    Stability: 2 - Stable
 Provides a few basic operating-system related utility functions.
--- a/doc/api/path.markdown
+++ b/doc/api/path.markdown
@ -1,6 +1,6 @@
 # Path
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 This module contains utilities for handling and transforming file
 paths.  Almost all these methods perform only string transformations.
--- a/doc/api/punycode.markdown
+++ b/doc/api/punycode.markdown
@ -1,6 +1,6 @@
 # punycode
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 [Punycode.js](https://mths.be/punycode) is bundled with io.js v1.0.0+ and
 Node.js v0.6.2+. Use `require('punycode')` to access it. (To use it with
--- a/doc/api/querystring.markdown
+++ b/doc/api/querystring.markdown
@ -1,6 +1,6 @@
 # Query String
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 <!--name=querystring-->
--- a/doc/api/readline.markdown
+++ b/doc/api/readline.markdown
@ -1,6 +1,6 @@
 # Readline
-    Stability: 2 - Unstable
+    Stability: 2 - Stable
 To use this module, do `require('readline')`. Readline allows reading of a
 stream (such as `process.stdin`) on a line-by-line basis.
--- a/doc/api/repl.markdown
+++ b/doc/api/repl.markdown
@ -1,6 +1,6 @@
 # REPL
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 A Read-Eval-Print-Loop (REPL) is available both as a standalone program and
 easily includable in other programs. The REPL provides a way to interactively
--- a/doc/api/smalloc.markdown
+++ b/doc/api/smalloc.markdown
@ -1,6 +1,6 @@
 # Smalloc
-    Stability: 1 - Experimental
+    Stability: 2 - Stable
 ## Class: smalloc
--- a/doc/api/stream.markdown
+++ b/doc/api/stream.markdown
@ -1,6 +1,6 @@
 # Stream
-    Stability: 2 - Unstable
+    Stability: 2 - Stable
 A stream is an abstract interface implemented by various objects in
 io.js.  For example a [request to an HTTP
--- a/doc/api/string_decoder.markdown
+++ b/doc/api/string_decoder.markdown
@ -1,6 +1,6 @@
 # StringDecoder
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 To use this module, do `require('string_decoder')`. StringDecoder decodes a
 buffer to a string. It is a simple interface to `buffer.toString()` but provides
--- a/doc/api/timers.markdown
+++ b/doc/api/timers.markdown
@ -1,6 +1,6 @@
 # Timers
-    Stability: 5 - Locked
+    Stability: 3 - Locked
 All of the timer functions are globals.  You do not need to `require()`
 this module in order to use them.
--- a/doc/api/tls.markdown
+++ b/doc/api/tls.markdown
@ -1,6 +1,6 @@
 # TLS (SSL)
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 Use `require('tls')` to access this module.
--- a/doc/api/tty.markdown
+++ b/doc/api/tty.markdown
@ -1,6 +1,6 @@
 # TTY
-    Stability: 2 - Unstable
+    Stability: 2 - Stable
 The `tty` module houses the `tty.ReadStream` and `tty.WriteStream` classes. In
 most cases, you will not need to use this module directly.
--- a/doc/api/url.markdown
+++ b/doc/api/url.markdown
@ -1,6 +1,6 @@
 # URL
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 This module has utilities for URL resolution and parsing.
 Call `require('url')` to use it.
--- a/doc/api/util.markdown
+++ b/doc/api/util.markdown
@ -1,6 +1,6 @@
 # util
-    Stability: 4 - API Frozen
+    Stability: 2 - Stable
 These functions are in the module `'util'`. Use `require('util')` to
 access them.
--- a/doc/api/v8.markdown
+++ b/doc/api/v8.markdown
@ -1,6 +1,6 @@
 # V8
-    Stability: 1 - Experimental
+    Stability: 2 - Stable
 This module exposes events and interfaces specific to the version of [V8][]
 built with io.js.  These interfaces are subject to change by upstream and are
--- a/doc/api/vm.markdown
+++ b/doc/api/vm.markdown
@ -1,6 +1,6 @@
 # Executing JavaScript
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 <!--name=vm-->
--- a/doc/api/zlib.markdown
+++ b/doc/api/zlib.markdown
@ -1,6 +1,6 @@
 # Zlib
-    Stability: 3 - Stable
+    Stability: 2 - Stable
 You can access this module with:
--- a/doc/api_assets/style.css
+++ b/doc/api_assets/style.css
@ -88,18 +88,10 @@ code a:hover {
 }
 .api_stability_2 {
-  background-color: #FFA000;
+  background-color: #4EBA0F;
 }
 .api_stability_3 {
  background-color: #AEC516;
 }
 .api_stability_4 {
  background-color: #009431;
 }
 .api_stability_5 {
  background-color: #0084B6;
 }