(DOCSP-15806) Source Connector Overview (#179)

Author: biniona-mongodb

snooty.toml

@@ -1,7 +1,7 @@
 name = "kafka-connector"
 title = "MongoDB Kafka Connector"
 intersphinx = ["https://docs.mongodb.com/manual/objects.inv"]
-toc_landing_pages = ["/sink-connector", "/sink-connector/configuration-properties", "/source-connector/configuration-properties"]
+toc_landing_pages = ["/sink-connector", "/source-connector", "/sink-connector/configuration-properties", "/source-connector/configuration-properties"]
 
 [constants]
 mkc = "MongoDB Kafka Connector"

source/source-connector.txt

@@ -1,13 +1,44 @@
-======================
-Kafka Source Connector
-======================
+================
+Source Connector
+================
 
 .. toctree::
    :titlesonly:
    :maxdepth: 1
 
    Configuration Properties </source-connector/configuration-properties>
-   Security and Authentication </source-connector/security-and-authentication>
    Usage Examples </source-connector/usage-examples>
    Fundamentals </source-connector/fundamentals>
 
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+Overview
+--------
+
+This section focuses on the **{+source-connector+}**.
+The {+source-connector+} is a {+kc+} connector that reads data from MongoDB and 
+writes data to {+ak+}.
+
+Configuration Properties
+------------------------
+
+To learn about configuration options for your source connector, see the 
+:ref:`Configuration Properties <source-configuration-index>` section.
+
+Usage Examples
+--------------
+
+To view examples of source connector configurations, see the 
+:ref:`Usage Examples <kafka-source-usage-examples>` section.
+
+Fundamentals
+------------
+
+To learn how features of the source connector work and how to configure them, see the 
+:ref:`Fundamentals <kafka-source-fundamentals>` section.

source/source-connector/fundamentals.txt

@@ -1,14 +1,18 @@
-=============================
-Source Connector Fundamentals
-=============================
+.. _kafka-source-fundamentals:
+
+============
+Fundamentals
+============
 
 .. toctree::
    :titlesonly:
    :maxdepth: 1
 
    Change Streams </source-connector/fundamentals/change-streams>
-   Document Metadata </source-connector/fundamentals/document-metadata>
-   Scaling Source Connectors </source-connector/fundamentals/scaling-source-connectors>
    Apply Schemas </source-connector/fundamentals/specify-schema>
 
-asdf
+Read the following sections to learn how {+source-connector+} features work and
+how to configure them:
+
+- :doc:`Receive Real-time Updates on Data Changes in MongoDB </source-connector/fundamentals/change-streams>`
+- :doc:`Apply Schemas to Documents </source-connector/fundamentals/specify-schema>`

source/source-connector/fundamentals/document-metadata.txt

@@ -1,6 +1,8 @@
-===============================
-Source Connector Usage Examples
-===============================
+.. _kafka-source-usage-examples:
+
+==============
+Usage Examples
+==============
 
 .. toctree::
    :titlesonly:
@@ -12,3 +14,11 @@ Source Connector Usage Examples
    Copy Existing Data </source-connector/usage-examples/copy-existing-data>
    Specify a Schema </source-connector/usage-examples/schema>
 
+Read the following sections to learn how to configure your {+source-connector+} to
+perform specific tasks:
+
+- :doc:`Filter and Transform Your MongoDB Change Stream with an Aggregation Pipeline </source-connector/usage-examples/custom-pipeline>`
+- :doc:`Listen for Changes in Multiple MongoDB Collections </source-connector/usage-examples/multiple-sources>`
+- :doc:`Customize the Name of the Topic to which your Source Connector Publishes Records </source-connector/usage-examples/topic-naming>`
+- :doc:`Copy Data From a MongoDB Collection onto an {+ak+} Topic </source-connector/usage-examples/copy-existing-data>`
+- :doc:`Ensure Documents Processed by Your Source Connector Conform to a Schema </source-connector/usage-examples/schema>`