Merge pull request #149 from norareidy/DOCSP-34797-key-definition

DOSCP-34797: Clarify key definition

Author: norareidy

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

@@ -4,6 +4,13 @@
 Apply Schemas
 =============
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta:: 
+   :keywords: structure, code example
+
 .. contents:: On this page
    :local:
    :backlinks: none
@@ -25,9 +32,9 @@ sent to Apache Kafka.
 
 .. important:: Note on Terminology
 
-   The word "key" has a slightly different meaning in the context
-   of BSON and Apache Kafka. In BSON, a "key" is a unique string identifier for
-   a field in a document.
+   This guide uses the Apache Kafka definition of the word "key", which differs
+   slightly from the BSON definition. In BSON, a "key" is a unique string identifier
+   for a field in a document.
 
    In Apache Kafka, a "key" is a byte array sent in a message used to determine
    what partition of a topic to write the message to. Kafka keys can be