DOCSP-43368: Cleanup

source/compatibility.txt

@@ -42,4 +42,100 @@ The first column lists the driver version.
 .. include:: /includes/compatibility/language-compatibility-table-c.rst
 
 For more information on how to read the compatibility tables, see our guide on 
-:ref:`MongoDB Compatibility Tables. <about-driver-compatibility>`
+:ref:`MongoDB Compatibility Tables. <about-driver-compatibility>`
+
+.. _platform-support:
+
+Platform Compatibility
+----------------------
+
+This section includes version compatibility information about platforms and
+toolchains that are supported by the {+driver-short+}.
+
+Operating Systems
+~~~~~~~~~~~~~~~~~
+
+The following operating systems are continually tested with the {+driver-short+}:
+
+.. list-table::
+  :header-rows: 1
+  :align: left
+
+  * - Operating System
+    - Notes
+
+  * - Debian
+    - Versions 9.2, 10.0, and 11.0
+  * - RHEL
+    - Versions 7.0, 7.1, 8.1, 8.2, and 8.3. RHEL derivatives
+      (for example, CentOS, Rocky Linux, or AlmaLinux) of the same release version are
+      supported. Fedora is also supported, but not continually tested.
+  * - Ubuntu
+    - Versions 16.04, 18.04, and 20.04. Subsequent minor releases
+      are also supported. Ubuntu 22.04 and newer is not yet tested. Ubuntu
+      derivatives based on supported Ubuntu versions are also supported.
+  * - Arch Linux
+    -
+  * - macOS
+    - Version 11.0
+  * - Windows Server 2008 and Windows Server 2016
+    - Windows variants of the same generation are supported
+
+
+Compilers
+~~~~~~~~~
+
+The following compilers are continually tested with the {+driver-short+}:
+
+.. list-table::
+  :header-rows: 1
+  :align: left
+
+  * - Compiler
+    - Notes
+  * - Clang
+    - Versions 3.7, 3.8, and 6.0. Newer versions
+      are also supported, as well as the corresponding Apple Clang releases.
+  * - GNU Compiler Collection (GCC)
+    - Versions 4.8, 5.4, 6.3, 7.5, 8.2, 8.3,
+      9.4, and 10.2. The MinGW-w64 GCC is also tested and supported.
+  * - Microsoft Visual C++ (MSVC)
+    - Tested with MSVC 14.x (Visual Studio 2015) and 15.x (Visual Studio
+      2017). Newer MSVC versions are supported but not yet tested.
+
+Architectures
+~~~~~~~~~~~~~
+
+The following CPU architectures are continually tested with the {+driver-short+}:
+
+.. list-table::
+  :align: left
+  :header-rows: 1
+
+  * - Architecture
+    - Notes
+  * - x86 (32-bit)
+    - Tested only on Windows
+  * - x86_64 (64-bit x86)
+    - Tested on Linux, macOS, and Windows
+  * - ARM / aarch64
+    - Tested on macOS and Linux
+  * - Power8 (ppc64le)
+    - Tested only on Linux
+  * - zSeries (s390x)
+    - Tested only on Linux
+
+Additional Platforms
+~~~~~~~~~~~~~~~~~~~~
+
+Other platforms and toolchains are not tested, but we expect similar versions
+of the preceding platforms to work. If you encounter a platform or toolchain that you
+expect to work and find that it does not, please open an issue describing the
+problem, or open a `GitHub Pull Request <https://github.com/mongodb/mongo-c-driver/pulls>`__ to fix it.
+
+.. important::
+
+   Simple pull requests to fix unsupported platforms are welcome, but will be
+   considered on a case-by-case basis. The acceptance of a pull request to fix the
+   libraries on an unsupported platform does not imply full support of that
+   platform.

source/connect.txt

@@ -1,4 +1,4 @@
-.. _c-sync-connect:
+.. _c-connect:
 
 ==================
 Connect to MongoDB

source/connect/connection-targets.txt

@@ -40,9 +40,6 @@ Then, pass your connection string to the ``mongoc_client_new()`` function.
    Follow the :atlas:`Atlas driver connection guide </driver-connection>`
    to retrieve your connection string.
 
-.. TODO, uncomment this and link to correct Stable API page for C, once written.
-.. To learn more about the {+stable-api+} feature, see the :ref:`<c-stable-api>`guide.
-
 The following code shows how to use the {+driver-short+} to connect to an Atlas cluster. The
 code also uses the ``mongoc_server_api_new()`` function to specify a {+stable-api+} version.
 
@@ -52,13 +49,11 @@ code also uses the ``mongoc_server_api_new()`` function to specify a {+stable-ap
    :end-before: end-connect-stable-api
    :dedent:
 
-
-.. TODO, add link to Stable API page for C Driver once created
-
 .. tip::
 
    When you connect to Atlas, we recommend using the {+stable-api+} client option to avoid
-   breaking changes when Atlas upgrades to a new version of {+mdb-server+}.
+   breaking changes when Atlas upgrades to a new version of {+mdb-server+}. To learn more
+   about the {+stable-api+}, see the :ref:`c-stable-api` guide.
 
 Local Deployments
 -----------------

source/connect/mongoclient.txt

@@ -37,9 +37,6 @@ Connection URI
 
 A standard connection string includes the following components:
 
-.. TODO, add this as last sentence for ``username:password`` description once a c auth page is made: 
-.. For more information about the ``authSource`` connection option, see :ref:`c-auth`. 
-
 .. list-table::
    :widths: 20 80
    :header-rows: 1
@@ -56,6 +53,8 @@ A standard connection string includes the following components:
 
      - Optional. Authentication credentials. If you include these, the client
        authenticates the user against the database specified in ``authSource``.
+       For more information about the ``authSource`` connection option, see the
+       :ref:`c-auth` guide.
 
    * - ``host[:port]``
 
@@ -96,9 +95,10 @@ to connect to a MongoDB instance:
 You can set the Stable API version client option to avoid breaking changes when 
 you upgrade to a new server version. 
 
-.. TODO, uncomment these once the Stable API for C Driver page is made.
-.. To learn more about the Stable API feature, 
-.. see the :ref:`Stable API page <c-stable-api>`. 
+.. tip::
+
+   To learn more about the {+stable-api+} feature, see the :ref:`c-stable-api`
+   guide. 
 
 The following code shows how you can specify the connection string and the 
 Stable API client option when connecting to a MongoDB deployment on Atlas 

source/connect/tls.txt

@@ -91,9 +91,9 @@ trusted by the native certificate store in use on the server.
 
 You can provide the client certificate in the following ways:
 
-- Setting the ``tlscertificatekeyfile`` parameter in your connection string to a `.pem` file containing the root certificate chain
-- Using the `mongoc_uri_set_option_as_utf8()` function to set the `MONGOC_URI_TLSCERTIFICATEKEYFILE` option
-  to a `.pem` file containing the root certificate chain
+- Setting the ``tlscertificatekeyfile`` parameter in your connection string to a ``.pem`` file containing the root certificate chain
+- Using the ``mongoc_uri_set_option_as_utf8()`` function to set the ``MONGOC_URI_TLSCERTIFICATEKEYFILE`` option
+  to a ``.pem`` file containing the root certificate chain
 
 .. tabs::
 

source/databases-collections.txt

@@ -22,6 +22,7 @@ Databases and Collections
    :maxdepth: 1
 
    /databases-collections/time-series
+   /databases-collections/run-command
 
 Overview
 --------

source/databases-collections/time-series.txt

@@ -81,7 +81,7 @@ The following example creates a time series collection named ``october2024`` in
    :start-after: start-create-time-series
    :end-before: end-create-time-series
    :dedent:
-   :emphasize-lines: 13-19
+   :emphasize-lines: 12-18
 
 To verify that you successfully created the time series collection, run
 the ``mongoc_database_find_collections_with_opts()`` function on the
@@ -95,7 +95,7 @@ the ``mongoc_database_find_collections_with_opts()`` function on the
       :start-after: start-list-collections
       :end-before: end-list-collections
       :dedent:
-      :emphasize-lines: 4-11
+      :emphasize-lines: 2-9
 
    .. output::
 

source/get-started/connect-to-mongodb.txt

@@ -24,17 +24,31 @@ Connect to MongoDB
 
          mkdir c-quickstart
 
-      Run the following commands to create a ``quickstart.c`` application file in the ``c-quickstart``
-      directory:
+      Select the tab corresponding to your operating system and run the
+      following commands to create a ``quickstart.c`` application file
+      in the ``c-quickstart`` directory:
 
-      .. code-block:: bash
+      .. tabs::
+
+          .. tab:: macOS / Linux
+             :tabid: create-file-mac-linux
+
+             .. code-block:: bash
+
+                cd c-quickstart
+                touch quickstart.c
+
+          .. tab:: Windows
+             :tabid: create-file-windows
+
+             .. code-block:: bash
 
-         cd c-quickstart
-         touch quickstart.c
+                cd c-quickstart
+                type nul > quickstart.c
 
    .. step:: Create your {+driver-short+} application
 
-      Copy and paste the following code into the ``quickstart.cpp`` file, which queries
+      Copy and paste the following code into the ``quickstart.c`` file, which queries
       the ``movies`` collection in the ``sample_mflix`` database:
 
       .. literalinclude:: /includes/get-started/quickstart.c

source/get-started/create-a-connection-string.txt

@@ -13,9 +13,8 @@ The connection string includes the hostname or IP address and
 port of your deployment, the authentication mechanism, user credentials 
 when applicable, and connection options.
 
-.. TODO
-.. To connect to an instance or deployment not hosted on Atlas, see the
-.. :ref:`c-connection-targets` guide.
+To connect to an instance or deployment not hosted on Atlas, see the
+:ref:`c-connection-targets` guide.
 
 .. procedure::
    :style: connected

source/get-started/download-and-install.txt

@@ -32,8 +32,8 @@ following command in your shell:
    apt-cache policy libmongoc-dev
 
 If the version of the driver that is available is not the version you want, you
-can install the driver from source.
-.. TODO: To learn how to install the driver from source, see the c-install-from-source guide.
+can install the driver from source. To learn how to install the driver from source,
+see the :ref:`c-install-from-source` guide.
 
 To learn how to install the driver by using a package manager, select the tab corresponding to
 your operating system:
@@ -205,10 +205,6 @@ your operating system:
 
           brew install mongo-c-driver
 
-.. TODO:
-    .. To learn how to install the driver libraries from source, see the
-    .. :ref:`c-install-from-source`` guide.
-
 After you complete these steps, you have the {+driver-short+} installed 
 on your machine.
 

source/includes/aggregation/aggregation.c

@@ -1,16 +1,15 @@
+#include <stdio.h>
 #include <bson/bson.h>
 #include <mongoc/mongoc.h>
-#include <stdio.h>
 
 int
-main (int argc, char *argv[])
+main (void)
 {
     mongoc_client_t *client;
     mongoc_collection_t *collection;
     mongoc_init ();
 
-    client =
-        mongoc_client_new ("<connection string URI>");
+    client = mongoc_client_new ("<connection string URI>");
     collection = mongoc_client_get_collection (client, "sample_restaurants", "restaurants");
 
     {

source/includes/databases-collections/databases-collections.c

@@ -2,7 +2,8 @@
 #include <mongoc/mongoc.h>
 #include <stdio.h>
 
-int main(int argc, char *argv[])
+int
+main (void)
 {
     bson_error_t error;
 

source/includes/get-started/quickstart.c

@@ -2,7 +2,8 @@
 #include <mongoc/mongoc.h>
 #include <stdio.h>
 
-int main (int argc, char *argv[])
+int
+main (void)
 {
     const bson_t *doc;
 

source/includes/indexes/indexes.c

@@ -3,17 +3,15 @@
 #include <stdio.h>
 
 int
-main (int argc, char *argv[])
+main (void)
 {
     mongoc_client_t *client;
     mongoc_collection_t *collection;
 
     mongoc_init ();
 
-    client =
-        mongoc_client_new ("<connection string URI>");
-    collection =
-        mongoc_client_get_collection (client, "sample_mflix", "movies");
+    client = mongoc_client_new ("<connection string URI>");
+    collection = mongoc_client_get_collection (client, "sample_mflix", "movies");
 
     {
         // start-remove-index

source/includes/read/change-streams.c

@@ -1,16 +1,15 @@
+#include <stdio.h>
 #include <bson/bson.h>
 #include <mongoc/mongoc.h>
-#include <stdio.h>
 
 int
-main (int argc, char *argv[])
+main (void)
 {
     mongoc_client_t *client;
     mongoc_collection_t *collection;
     mongoc_init ();
 
-    client =
-        mongoc_client_new ("<connection string URI>");
+    client = mongoc_client_new ("<connection string URI>");
     collection = mongoc_client_get_collection (client, "sample_restaurants", "restaurants");
 
     {

source/includes/read/count.c

@@ -1,17 +1,15 @@
+#include <stdio.h>
 #include <bson/bson.h>
 #include <mongoc/mongoc.h>
-#include <stdio.h>
 
 int
-main (int argc, char *argv[])
+main (void)
 {
     mongoc_client_t *client;
     mongoc_collection_t *collection;
-
     mongoc_init ();
 
-    client =
-        mongoc_client_new ("<connection string URI>");
+    client = mongoc_client_new ("<connection string URI>");
     collection = mongoc_client_get_collection (client, "sample_mflix", "movies");
 
     {