DOCSP-20586: versioned API renamed to stable API (#789)

* DOCSP-20586: versioned API renamed to stable API

Author: Chris Cho

snooty.toml

@@ -13,3 +13,4 @@ csharp-docs-versioned = "https://mongodb.github.io/mongo-csharp-driver/2.14"
 
 java-version = "4.4"
 java-api = "https://mongodb.github.io/mongo-java-driver/{+java-version+}"
+stable-api = "Stable API"

source/c.txt

@@ -17,10 +17,10 @@ MongoDB C Driver
 Introduction
 ------------
 
-Welcome to the documentation site for the official MongoDB C driver. 
-You can add the driver to your application to work with MongoDB in C. 
-Download the required libraries, ``libmongoc`` and ``libbson``,  from 
-`mongoc.org <https://mongoc.org/libmongoc/current/installing.html>`__ 
+Welcome to the documentation site for the official MongoDB C driver.
+You can add the driver to your application to work with MongoDB in C.
+Download the required libraries, ``libmongoc`` and ``libbson``,  from
+`mongoc.org <https://mongoc.org/libmongoc/current/installing.html>`__
 or set up a runnable project by following our tutorial.
 
 - `Tutorial <http://mongoc.org/libmongoc/current/tutorial.html>`__
@@ -79,16 +79,18 @@ Connect to MongoDB Atlas
 See `Advanced Connections <http://mongoc.org/libmongoc/current/advanced-connections.html>`__
 for more ways to connect.
 
-Versioned API
--------------
+{+stable-api+}
+--------------
+
+You can use the {+stable-api+} feature starting with MongoDB Server version
+5.0 and C Driver version 1.18. When you use the {+stable-api+} feature,
+you can update your driver or server without worrying about backward
+compatibility issues with any commands covered by the {+stable-api+}.
+
+.. include:: /includes/stable-api-notice.rst
 
-You can use the `Versioned API
-<https://docs.mongodb.com/v5.0/reference/versioned-api/>`__ feature
-starting with MongoDB Server version 5.0 and C Driver version 1.18. When
-you use the Versioned API feature, you can update your driver or server
-without worrying about backward compatibility issues with any commands
-covered by the Versioned API. To use this feature, construct a MongoDB
-client instance, specifying a version of the Versioned API:
+To use this feature, construct a MongoDB client instance, specifying a version
+of the {+stable-api+}:
 
 .. code-block:: c
 
@@ -104,7 +106,7 @@ client instance, specifying a version of the Versioned API:
    uri = mongoc_uri_new_with_error (uri_string, &error);
    client = mongoc_client_new_from_uri (uri);
 
-   // Set the version of the Versioned API on the client.
+   // Set the version of the {+stable-api+} on the client.
    api = mongoc_server_api_new (MONGOC_SERVER_API_V1);
    mongoc_client_set_server_api (client, api, &error);
 
@@ -114,7 +116,7 @@ Connect to a MongoDB Server on Your Local Machine
 .. include:: /includes/localhost-connection.rst
 
 To test whether you can connect to your server, replace the connection
-string in the :ref:`Connect to MongoDB Atlas <connect-atlas-c-driver>` code 
+string in the :ref:`Connect to MongoDB Atlas <connect-atlas-c-driver>` code
 example and run it.
 
 Compatibility
@@ -123,7 +125,10 @@ Compatibility
 MongoDB Compatibility
 ~~~~~~~~~~~~~~~~~~~~~
 
-.. include:: /includes/extracts/c-driver-compatibility-matrix-mongodb.rst
+The following compatibility table specifies the recommended version(s) of the
+MongoDB C driver for use with a specific version of MongoDB.
+
+The first column lists the driver version(s).
 
 .. include:: /includes/mongodb-compatibility-table-c.rst
 
@@ -132,7 +137,10 @@ MongoDB Compatibility
 Language Compatibility
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. include:: /includes/extracts/c-driver-compatibility-matrix-language.rst
+The following compatibility table specifies the recommended version(s) of the
+MongoDB C driver for use with a specific version of C.
+
+The first column lists the driver version(s).
 
 .. include:: /includes/language-compatibility-table-c.rst
 

source/csharp.txt

@@ -17,9 +17,9 @@ MongoDB C#/.NET Driver
 Introduction
 ------------
 
-Welcome to the documentation site for the official MongoDB C#/.NET 
-driver. You can add the driver to your application to work with MongoDB 
-in C#/.NET. Download it using `NuGet <https://www.nuget.org/>`__ or 
+Welcome to the documentation site for the official MongoDB C#/.NET
+driver. You can add the driver to your application to work with MongoDB
+in C#/.NET. Download it using `NuGet <https://www.nuget.org/>`__ or
 set up a runnable project by following our Getting Started guide.
 
 - `Getting Started <{+csharp-docs-versioned+}/getting_started/>`__
@@ -74,26 +74,31 @@ Connect to MongoDB Atlas
 See `Connecting <{+csharp-docs-versioned+}/reference/driver/connecting/>`__
 for more information.
 
-Versioned API
--------------
+{+stable-api+}
+--------------
+
+You can use the {+stable-api+} feature starting with MongoDB Server version
+5.0 and C#/.NET Driver version 2.13. When you use the {+stable-api+} feature,
+you can update your driver or server without worrying about backward
+compatibility issues with any commands covered by the {+stable-api+}.
 
-You can use the `Versioned API
-<https://docs.mongodb.com/v5.0/reference/versioned-api/>`__ feature
-starting with MongoDB Server version 5.0 and C#/.NET Driver version 2.13. When
-you use the Versioned API feature, you can update your driver or server
-without worrying about backward compatibility issues with any commands
-covered by the Versioned API. To use this feature, construct a MongoDB
-client instance, specifying a version of the Versioned API:
+.. include:: /includes/stable-api-notice.rst
+
+To use this feature, construct a MongoDB client instance, specifying a version
+of the {+stable-api+}:
 
 .. code-block:: csharp
 
    // Replace <connection string> with your MongoDB deployment's connection string.
    var settings = MongoClientSettings.FromConnectionString("<connection string>");
 
-   // Set the version of the Versioned API on the client.
+   // Set the version of the {+stable-api+} on the client.
    settings.ServerApi = new ServerApi(ServerApiVersion.V1);
    var client = new MongoClient(settings);
 
+See the MongoDB Server reference on the :manual:`{+stable-api+} </reference/stable-api/>`
+for more information.
+
 Connect to a MongoDB Server on Your Local Machine
 -------------------------------------------------
 
@@ -109,12 +114,20 @@ Compatibility
 MongoDB Compatibility
 ~~~~~~~~~~~~~~~~~~~~~
 
+The following compatibility table specifies the recommended version(s) of the
+MongoDB C#/.NET driver for use with a specific version of MongoDB.
+
+The first column lists the driver version(s).
+
 .. include:: /includes/mongodb-compatibility-table-csharp.rst
 
 Language Compatibility
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. include:: /includes/extracts/csharp-driver-compatibility-matrix-language.rst
+The following compatibility table specifies the recommended version(s) of the
+MongoDB C#/.NET driver for use with a specific version of .NET.
+
+The first column lists the driver version(s).
 
 .. include:: /includes/language-compatibility-table-csharp.rst
 

source/cxx.txt

@@ -17,10 +17,10 @@ MongoDB C++ Driver
 Introduction
 ------------
 
-Welcome to the documentation site for the official MongoDB C++ driver. 
-You can add the driver to your application to work with MongoDB using 
-the C++11 or later standard. Download the library, ``mongocxx``,  
-from `mongocxx.org <http://mongocxx.org/mongocxx-v3/installation/>`__ 
+Welcome to the documentation site for the official MongoDB C++ driver.
+You can add the driver to your application to work with MongoDB using
+the C++11 or later standard. Download the library, ``mongocxx``,
+from `mongocxx.org <http://mongocxx.org/mongocxx-v3/installation/>`__
 or set up a runnable project by following our tutorial.
 
 - `Tutorial <http://mongocxx.org/mongocxx-v3/tutorial/>`__
@@ -78,7 +78,10 @@ Compatibility
 MongoDB Compatibility
 ~~~~~~~~~~~~~~~~~~~~~
 
-.. include:: /includes/extracts/cpp-driver-compatibility-matrix-mongodb.rst
+The following compatibility table specifies the recommended version(s) of the
+MongoDB C++ driver for use with a specific version of MongoDB.
+
+The first column lists the driver version(s).
 
 .. include:: /includes/mongodb-compatibility-table-cxx.rst
 
@@ -87,7 +90,10 @@ MongoDB Compatibility
 Language Compatibility
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. include:: /includes/extracts/cpp-driver-compatibility-matrix-language.rst
+The following compatibility table specifies the recommended version(s) of the
+MongoDB C++ driver for use with a specific version of C++.
+
+The first column lists the driver version(s).
 
 .. include:: /includes/language-compatibility-table-cxx.rst