DOCSP-38482: Update C landing page (#8)

* DOCSP-38482: Update C landing page

* edits

* cmake

* snooty edit

Author: norareidy

snooty.toml

@@ -19,11 +19,12 @@ toc_landing_pages = [
     "/libmongoc/tutorials",
     "/libmongoc/tutorials/obtaining-libraries",
 ]
+sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
 
 [constants]
 
 version = "1.26"
-full-version = "{+version+}.1"
+full-version = "{+version+}.2"
 is-experimental = "is part of the experimental Queryable Encryption API and may be subject to breaking changes in future releases."
 range-is-experimental = "Range algorithm is experimental only and not intended for public use. It is subject to breaking changes."
 api-is-experimental = "This API {+is-experimental+}"

source/index.txt

@@ -8,13 +8,18 @@ MongoDB C Driver
    :name: programming_language
    :values: c
 
-
 .. facet::
    :name: genre
-   :values: reference 
+   :values: reference
 
 .. meta:: 
-   :keywords: libbson, libmongoc
+   :keywords: code example, get started, sample app
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: twocols
 
 .. toctree::
    :titlesonly:
@@ -26,7 +31,55 @@ 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``, by following the instructions on :ref:`installing`
-or set up a runnable project by following our :ref:`mongoc_tutorial`.
+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``, by following
+the :ref:`obtaining_libraries` instructions or set up a runnable project by
+following our tutorial.
+
+- :ref:`Tutorial <mongoc_tutorial>`
+
+- :ref:`Usage Guide <libmongoc>`
+
+- `MongoDB Developer Center <https://www.mongodb.com/developer/languages/c/>`__
+
+- `API Reference <https://mongoc.org/libmongoc/current/api.html>`_
+
+- `Changelog <https://github.com/mongodb/mongo-c-driver/releases>`__
+
+- `Source Code <https://github.com/mongodb/mongo-c-driver>`__
+
+- `Examples <https://github.com/mongodb/mongo-c-driver/tree/master/src/libmongoc/examples>`__
+
+- `Additional BSON Examples <https://github.com/mongodb/mongo-c-driver/tree/master/src/libbson/examples>`__
+
+Compatibility
+-------------
+
+MongoDB Compatibility
+~~~~~~~~~~~~~~~~~~~~~
+
+The compatibility table in this section specifies the recommended version or
+versions of the MongoDB C driver for use with a specific version of MongoDB.
+
+The first column lists the driver version.
+
+.. sharedinclude:: dbx/lifecycle-schedule-callout.rst
+
+.. include:: /libmongoc/includes/mongodb-compatibility-table-c.rst
+
+.. include:: /libmongoc/includes/older-server-versions-unsupported.rst
+
+Language Compatibility
+~~~~~~~~~~~~~~~~~~~~~~
+
+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:: /libmongoc/includes/language-compatibility-table-c.rst
+
+.. include:: /libmongoc/includes/about-driver-compatibility.rst
+
+.. include:: /libmongoc/includes/help-links-c.rst

source/libmongoc/includes/about-driver-compatibility.rst

@@ -0,0 +1,2 @@
+For more information on how to read the compatibility tables, see our guide on
+`MongoDB Compatibility Tables <https://www.mongodb.com/docs/drivers/about-compatibility/>`__.

source/libmongoc/includes/help-links-c.rst

@@ -0,0 +1,6 @@
+How To Get Help
+---------------
+
+- Ask questions on our :community-forum:`MongoDB Community Forums <>`.
+- Visit our :technical-support:`Support Channels </>`.
+- File a bug or feature request on :issue:`JIRA <CDRIVER>`.

source/libmongoc/includes/language-compatibility-table-c.rst

@@ -0,0 +1,31 @@
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :class: compatibility
+   :widths: 40 15 15 15 15
+
+   * - C Driver Version
+     - C17/C18
+     - C11
+     - C99
+     - C89
+   * - 1.26
+     - ✓
+     - ✓
+     - ✓
+     - 
+   * - 1.25
+     - ✓
+     - ✓
+     - ✓
+     -
+   * - 1.24
+     - ✓
+     - ✓
+     - ✓
+     -
+   * - <= 1.23
+     -
+     - ✓
+     - ✓
+     - ✓