(DOCS-15272): v5.0 backport for count command in stable API (#1055)

* (DOCS-15272): v5.0 backport for count command in stable API

* (DOCS-15272): v5.0 backport for count command in stable API (#1052)

* DOCS-15272 addition (#1053)

* remove 6.0 ref

Author: jeff-allen-mongo

source/reference/command/count.txt

@@ -158,6 +158,14 @@ Definition
         :ref:`collStats pipeline stage with the count <collstat-count>`
         option.
 
+Stable API Support
+------------------
+
+Starting in MongoDB 5.0.9, the ``count`` command is included in
+:ref:`Stable API <stable-api>` V1. To use the ``count`` command in the
+Stable API, you must connect your driver to a deployment that is running
+MongoDB 5.0.9 or greater.
+
 Behavior
 --------
 

source/reference/stable-api-changelog.txt

@@ -0,0 +1,131 @@
+.. _stable-api-changelog:
+
+====================
+Stable API Changelog
+====================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+This page contains a changelog of the Stable API. The Stable API is
+actively being expanded to include new database commands and
+functionality.
+
+The database commands included in the Stable API depend on the MongoDB
+version you are using. This page describes the MongoDB and Stable API
+versions when a database command or specific sub-features of a command
+are available.
+
+Database Commands
+-----------------
+
+The following table describes:
+
+- The commands included in each version of the Stable API.
+
+- The MongoDB version in which the command was added to the Stable API.
+
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 15 5 10
+
+   * - Command
+     - Stable API Version
+     - Added to Stable API in MongoDB Version
+
+   * - :dbcommand:`count`
+     - V1
+     - MongoDB 6.0, 5.0.9
+   * - :dbcommand:`abortTransaction`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`aggregate` (with limitations) [#stable-api-command-limitations]_
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`authenticate`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`collMod`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`commitTransaction`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`create` (with limitations) [#stable-api-command-limitations]_
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`createIndexes` (with limitations) [#stable-api-command-limitations]_
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`delete`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`drop`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`dropDatabase`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`dropIndexes`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`endSessions`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`explain` [#stable-api-explain]_
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`find` (with limitations) [#stable-api-command-limitations]_
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`findAndModify`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`getMore`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`insert`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`hello`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`killCursors`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`listCollections`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`listDatabases`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`listIndexes`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`ping`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`refreshSessions`
+     - V1
+     - MongoDB 5.0
+   * - :dbcommand:`update`
+     - V1
+     - MongoDB 5.0
+
+.. [#stable-api-command-limitations]
+
+   API V1 may not support all available options for these commands.
+   Refer to the specific command documentation for limitations specific
+   to API V1.
+
+.. [#stable-api-explain]
+
+   MongoDB does not guarantee that the output of the
+   :dbcommand:`explain` command will conform to the same format in
+   future API versions.

source/reference/stable-api-reference.txt

@@ -41,4 +41,3 @@ your application code tries to use commands and behaviors deprecated in
 API V1. Once your application tests pass and all deprecation errors 
 have been fixed, you will be ready to test your application with API 
 V2.
-

source/reference/stable-api.txt

@@ -372,77 +372,14 @@ Stable API, you can redeploy it with the new MongoClient options
 and be confident that future server upgrades won't negatively
 impact your application.
 
-Example: :dbcommand:`count` Migration 
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This example shows how to migrate an application that implements the
-:dbcommand:`count` command to an alternative method of counting 
-documents. Since the :dbcommand:`count` command does not belong to the 
-Stable API, this application cannot use the Stable API until the 
-:dbcommand:`count` command is removed from the code.
-
-Use the sample code to create a ``sales`` collection in 
-:binary:`~bin.mongosh`:
-
-.. code-block:: javascript
-
-   db.sales.insertMany([
-       { "_id" : 1, "item" : "abc", "price" : 10, "quantity" : 2, "date" : ISODate("2021-01-01T08:00:00Z") },
-       { "_id" : 2, "item" : "jkl", "price" : 20, "quantity" : 1, "date" : ISODate("2021-02-03T09:00:00Z") },
-       { "_id" : 3, "item" : "xyz", "price" : 5, "quantity" : 5, "date" : ISODate("2021-02-03T09:05:00Z") },
-       { "_id" : 4, "item" : "abc", "price" : 10, "quantity" : 10, "date" : ISODate("2021-02-15T08:00:00Z") },
-       { "_id" : 5, "item" : "xyz", "price" : 5, "quantity" : 10, "date" : ISODate("2021-02-15T09:05:00Z") },
-       { "_id" : 6, "item" : "xyz", "price" : 5, "quantity" : 5, "date" : ISODate("2021-02-15T12:05:10Z") },
-       { "_id" : 7, "item" : "xyz", "price" : 5, "quantity" : 10, "date" : ISODate("2021-02-15T14:12:12Z") },
-       { "_id" : 8, "item" : "abc", "price" : 10, "quantity" : 5, "date" : ISODate("2021-03-16T20:20:13Z") }
-   ])
-
-Stable API Error Response
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-For example, issuing ``db.sales.count()`` results in this error:
-
-.. code-block:: javascript
-   :copyable: false
-
-   {
-	 "ok" : 0,
-	 "errmsg" : "Provided apiStrict:true, but the command count is not in API Version 1",
-	 "code" : 323,
-	 "codeName" : "APIStrictError"
-   }
-
-However, the :dbcommand:`aggregate` command is
-:ref:`in the Stable API <api-v1-command-list>` and can be used to 
-obtain a count. Use the sample code to obtain a count from the ``sales``
-collection in :binary:`~bin.mongosh`:
-
-.. code-block:: javascript
-
-   db.sales.aggregate([
-     { 
-         $group: { 
-           _id: null, 
-           count: { $count: { } }
-         }
-     }
-   ]) 
-
-This results in a document where the ``count`` field contains the 
-number of documents in the collection:
-
-.. code-block:: javascript
-
-  { "_id" : null, "count" : 8 }
-
 How To Use Commands and Features Outside of the Stable API
 ----------------------------------------------------------
 
 To use commands and features outside of the Stable API, you can 
 connect to your deployment with a *non-strict* client. By default,
 clients are *non-strict*.
 
-Use the sample code to create a *non-strict* client:
+To create a *non-strict* client, use the following sample code:
 
 .. tabs-drivers::
 
@@ -571,8 +508,8 @@ Use the sample code to create a *non-strict* client:
          :end-before: End Versioned API Example 3
 
 Using this non-strict client allows you to run commands outside of the
-Stable API. For example, this non-strict client now allows you to 
-use the :dbcommand:`count` command once again.
+Stable API. For example, this non-strict client allows you to run the
+:dbcommand:`createUser` command.
 
 .. important:: 
 
@@ -581,49 +518,13 @@ use the :dbcommand:`count` command once again.
 
 .. _api-v1-command-list:
 
-API V1 Commands
----------------
-
-API V1 protects you from API-breaking changes 
-for the following commands:
-
-- :dbcommand:`abortTransaction`
-- :dbcommand:`aggregate` (with limitations) [#stable-api-command-limitations]_
-- :dbcommand:`authenticate`
-- :dbcommand:`collMod`
-- :dbcommand:`commitTransaction`
-- :dbcommand:`create` (with limitations) [#stable-api-command-limitations]_
-- :dbcommand:`createIndexes` (with limitations) [#stable-api-command-limitations]_
-- :dbcommand:`delete`
-- :dbcommand:`drop`
-- :dbcommand:`dropDatabase`
-- :dbcommand:`dropIndexes`
-- :dbcommand:`endSessions`
-- :dbcommand:`explain` (with limitations) [#stable-api-explain]_
-- :dbcommand:`find` (with limitations) [#stable-api-command-limitations]_
-- :dbcommand:`findAndModify`
-- :dbcommand:`getMore`
-- :dbcommand:`insert`
-- :dbcommand:`hello`
-- :dbcommand:`killCursors`
-- :dbcommand:`listCollections`
-- :dbcommand:`listDatabases`
-- :dbcommand:`listIndexes`
-- :dbcommand:`ping`
-- :dbcommand:`refreshSessions`
-- :dbcommand:`update`
-
-.. [#stable-api-command-limitations]
-
-   API V1 may not support all available options for these commands.
-   Refer to the specific command documentation for limitations specific
-   to API V1.
-
-.. [#stable-api-explain]
-
-   MongoDB does not guarantee that the output of the
-   :dbcommand:`explain` command will conform to the same format in
-   future API versions.
+Stable API Commands
+-------------------
+
+The database commands included in Stable API V1 depend on the MongoDB
+version you are using. To view the database commands included in the
+Stable API and the MongoDB version they were introduced, see
+:ref:`stable-api-changelog`.
 
 Parameters
 ----------
@@ -695,8 +596,8 @@ ignored.
 
 .. _api-error-responses:
 
-API Error Responses
-~~~~~~~~~~~~~~~~~~~
+Stable API Error Responses
+--------------------------
 
 This table shows error responses for problematic Stable API requests.
 
@@ -742,4 +643,5 @@ This table shows error responses for problematic Stable API requests.
    :titlesonly:
    :hidden:
 
-   /reference/stable-api-reference
+   /reference/stable-api-reference
+   /reference/stable-api-changelog