(DOCSP-18947) Add Converters Discussion to Schema Page (#180)

Author: biniona-mongodb

source/includes/schema-converter-important.rst

@@ -0,0 +1,5 @@
+.. important:: Converters
+
+   If you want to send your data through {+ak+} with {+avro-short+} binary encoding,
+   you must use an {+avro-short+} converter. For more information, see the guide on
+   :ref:`Converters <intro-converters>`.

source/source-connector/fundamentals/specify-schema.txt

@@ -48,8 +48,8 @@ following combinations of schemas:
    To see a discussion on the benefits of using schemas with Kafka Connect,
    see `this article from Confluent <https://docs.confluent.io/platform/current/schema-registry/index.html#ak-serializers-and-deserializers-background>`__.
 
-To see full properties files for specifying a schema, see our specify a schema
-usage example. <TODO: link to example>
+If you want to send data through {+ak+} with a specific data format, such as {+avro+}
+or JSON Schema, see the :ref:`<intro-converters>` guide.
 
 To learn more about keys and values in Apache Kafka, see the
 `official Apache Kafka introduction <http://kafka.apache.org/intro#intro_concepts_and_terms>`__.
@@ -78,7 +78,7 @@ event documents. You should use the default key schema unless you remove the
 ``_id`` field from your change event document using either of the transformations
 :ref:`described in this guide here <source-schema-for-modified-document>`.
 
-If you specify either of these transformations and would like to use a key
+If you specify either of these transformations and want to use a key
 schema for your incoming documents, you must specify a key schema
 :ref:`as described in the specify a schema section of this guide <source-specify-avro-schema>`.
 
@@ -98,7 +98,7 @@ should use the default value schema unless you transform your change event
 documents
 :ref:`as described in this guide here <source-schema-for-modified-document>`.
 
-If you specify either of these transformations and would like to use a value schema for your
+If you specify either of these transformations and want to use a value schema for your
 incoming documents, you must use one of the mechanisms described in the
 :ref:`schemas for transformed documents section of this guide <source-schema-for-modified-document>`.
 
@@ -125,8 +125,8 @@ you must do the following to apply schemas:
 - :ref:`Specify schemas <source-specify-avro-schema>`
 - :ref:`Have the connector infer a value schema <source-infer-a-schema>`
 
-To learn more, see our
-:doc:`guide on source connector configuration properties </source-connector/configuration-properties>`.
+To learn more about the preceding configuration options, see the
+:ref:`<source-configuration-change-stream>` page.
 
 .. _source-specify-avro-schema:
 
@@ -154,10 +154,13 @@ the following tabs to see how to specify a schema for document values and keys:
          output.format.value=schema
          output.schema.value=<your avro schema>
 
-.. TODO: Make sure this link goes to correct avro schema page
+To view an example that demonstrates how to specify a schema, see the
+:ref:`<source-usage-example-schema>` usage example.
 
-To learn more about Avro Schema, see our
-:doc:`guide on Avro schema </introduction/data-formats/avro>`.
+To learn more about Avro Schema, see the
+:ref:`Data Formats <kafka-df-avro-schema>` guide.
+
+.. include:: /includes/schema-converter-important.rst
 
 .. _source-infer-a-schema:
 
@@ -183,8 +186,3 @@ following options:
    schema and transform your MongoDB change event documents, you must specify a
    key schema as described in
    :ref:`the specify schemas section of this guide <source-specify-avro-schema>`.
-
-Properties Files
-----------------
-
-TODO: <Complete Source Connector Properties File For Default and Specified Schemas>

source/source-connector/usage-examples/schema.txt

@@ -108,11 +108,7 @@ the example schema below:
 .. literalinclude:: /includes/source-connector/usage-examples/customers.avro
    :language: json
 
-.. important:: Converters
-
-   If you want to send your data through {+ak+} with {+avro-short+} binary encoding,
-   you must use an {+avro-short+} converter. For more information, see the guide on
-   :ref:`Converters <intro-converters>`.
+.. include:: /includes/schema-converter-important.rst
 
 .. _usage-example-schema-omit-metadata: