(DOCSP-43999) Promo admonition.

snooty.toml

@@ -16,6 +16,7 @@ toc_landing_pages = [
 ]
 
 [constants]
+atlas-sp = "Atlas Stream Processing"
 connector = "MongoDB Kafka Connector"
 connector-short = "Kafka Connector"
 connector-long = "MongoDB Connector for Apache Kafka"
@@ -25,6 +26,8 @@ kafka-connect-long = "Confluent Kafka Connect"
 avro-long = "Apache Avro"
 avro = "Avro"
 avro-converter = "Kafka Connect Avro Converter (Avro Converter)"
+aws = ":abbr:`AWS (Amazon Web Services)`"
+azure = "Microsoft Azure"
 protobuf-converter = "Kafka Connect Protobuf Converter"
 json-schema-converter = "Kafka Connect JSON Schema Converter"
 connector_version = "1.14"
@@ -34,6 +37,7 @@ connector_version_github_tag = "master"
 connector_kafka_version_major = "2"
 connector_kafka_version_minor = "6"
 connector_kafka_version_docs = "https://kafka.apache.org/{+connector_kafka_version_major+}{+connector_kafka_version_minor+}"
+service = "Atlas"
 sink-connector = "MongoDB Kafka sink connector"
 source-connector = "MongoDB Kafka source connector"
 sink-connector-title = "MongoDB Kafka Sink Connector"
@@ -59,3 +63,4 @@ jmx-port-mapping = "35000"
 sandbox-directory = "kafka-edu/docs-examples/mongodb-kafka-base/"
 win-sandbox-directory = "kafka-edu\\docs-examples\\mongodb-kafka-base\\"
 cluster = "MongoDB cluster"
+clusters = "MongoDB clusters"

source/includes/atlas-sp.rst

@@ -0,0 +1,9 @@
+.. note::
+
+   Atlas Stream Processing provides MongoDB-native tooling to
+   continuously process streaming data, validate schemas, and
+   materialize views into either Atlas database collections or Apache
+   Kafka topics.
+
+   To learn more about Atlas Stream Processing, see the
+   `documentation <https://www.mongodb.com/docs/atlas/atlas-sp/overview/>`__.

source/index.txt

@@ -18,6 +18,7 @@ MongoDB Kafka Connector
    Security and Authentication </security-and-authentication>
    Monitoring </monitoring>
    Migrate from the Community Connector <migrate-from-kafka-connect-mongodb>
+   Compare Kafka Connector and Atlas Stream Processing <kafka-connector-atlas-stream-processing-comparison>
    Troubleshooting </troubleshooting>
    How to Contribute </contribute>
    Issues & Help </issues-and-help>
@@ -47,19 +48,7 @@ offerings to host your {+kafka+} cluster and {+connector+}:
   - To learn more about the MongoDB Source Connector, read the `documentation <https://docs.redpanda.com/current/deploy/deployment-option/cloud/managed-connectors/create-mongodb-source-connector/>`__.
   - To learn more about the MongoDB Sink Connector, read the `documentation <https://docs.redpanda.com/current/deploy/deployment-option/cloud/managed-connectors/create-mongodb-sink-connector/>`__.
 
-.. note::
-
-   You can also use Atlas Stream Processing, which is a MongoDB-native way to
-   process streaming data by using the MongoDB Query API. It transforms the way
-   that developers build modern applications.
-
-   Use Atlas Stream Processing to continuously process streaming data,
-   validate schemas, and materialize views into either Atlas database
-   collections or Apache Kafka topics.
-
-   To learn more about Atlas Stream Processing, see the
-   `Atlas Stream Processing <https://www.mongodb.com/products/platform/atlas-stream-processing>`__
-   product page or read the `docs <https://www.mongodb.com/docs/atlas/atlas-sp/overview/>`__.
+.. include:: /includes/atlas-sp.rst
 
 What's New
 ----------

source/introduction.txt

@@ -20,3 +20,5 @@ Read the following sections to learn about the {+connector+}, {+kafka-connect+},
 - :doc:`Connect to MongoDB </introduction/connect>`
 - :doc:`Data Formats </introduction/data-formats>`
 - :doc:`Converters </introduction/converters>`
+
+.. include:: /includes/atlas-sp.rst

source/kafka-connector-atlas-stream-processing-comparison.txt

@@ -0,0 +1,83 @@
+.. _kafka-connector-atlas-stream-processing-comparison:
+
+===================================================
+Compare Kafka Connector and Atlas Stream Processing
+===================================================
+
+.. toctree::
+   :titlesonly:
+   :maxdepth: 2
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+This page provides a comparison of the feature sets of the MongoDB
+Kafka Connector and {+atlas-sp+} to help you identify which tool
+best suits your use case.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 40 40
+
+   * - Feature
+     - Kafka Connector
+     - Atlas Stream Processing
+
+   * - Hosting
+     - Hosting required for your {+kafka+} cluster and the Kafka
+       Connector. Use partner services such as Confluent Cloud, Amazon
+       Managed Streaming, or Redpanda Cloud when possible. 
+     - Stream processing functionality fully managed by {+service+}.
+       Hosting required for your {+kafka+} cluster.
+
+   * - Installation
+     - Installation required either locally or on Confluent.
+     - No installation required.
+
+   * - Connectivity Tooling
+     - MongoDB Java Driver required.
+     - Connection managed by {+service+}.
+
+   * - Supported Stream Processing Capabilities
+     - To process streaming data handled by Kafka Connector, you must
+       do one of the following:
+       - Extend the Kafka Connector with SMTs or custom Java
+       - Use or write external tooling
+     - Available through the MongoDB aggregation framework, with
+       extensions specific to stream processing.
+
+   * - Windowing
+     - No support for windowing. You must manually configure windowing
+       with the Kafka Streams API or other external tooling.
+     - Support for highly configurable
+       :atlas:`windows <atlas-stream-processing/windows/>`.
+
+   * - Connection Type Support
+     - - Kafka clusters
+       - {+service+} databases
+       - {+service+} collections
+     - - Kafka clusters
+       - {+service+} {+clusters+}
+       - {+service+} databases
+       - {+service+} collections
+       - HTTPS
+
+   * - Security Features
+     - - SSL/TLS
+       - X.509
+       - {+aws+} IAM
+       - User must develop all other authentication tools
+     - - SSL/TLS
+       - X.509
+       - VPC Peering with {+aws+}
+       - Private Link with {+aws+} Confluent
+       - Private Link with {+aws+} MSK
+       - Private Link with {+azure+} Event Hub
+
+   * - Pricing
+     - Pricing dependent on your hosting provider.
+     - Hourly pricing managed by {+atlas-sp+} Typical costs
+       approximately 25% of the cost of the Kafka Connector. 

source/migrate-from-kafka-connect-mongodb.txt

@@ -12,6 +12,8 @@ The following sections list the changes you must make to your Kafka
 Connect sink connector configuration settings and custom classes to transition
 to the {+sink-connector+}.
 
+.. include:: /includes/atlas-sp.rst
+
 Update Configuration Settings
 -----------------------------
 

source/quick-start.txt

@@ -17,6 +17,8 @@
 .. meta::
    :keywords: get started, tutorial, code example
 
+.. include:: /includes/atlas-sp.rst
+
 Overview
 --------
 

source/sink-connector.txt

@@ -17,6 +17,8 @@ Sink Connector
    :depth: 2
    :class: singlecol
 
+.. include:: /includes/atlas-sp.rst
+
 Overview
 --------
 

source/source-connector.txt

@@ -18,6 +18,8 @@ Source Connector
    :depth: 2
    :class: singlecol
 
+.. include:: /includes/atlas-sp.rst
+
 Overview
 --------