DOCSP-11928: [KAFKA] Add support for dotted field names

Author: steveren

source/kafka-sink-data-formats.txt

@@ -169,6 +169,11 @@ Nested Field Schema Example
 The converter handles schemas with nested key or value structures.
 The following is an example AVRO schema with nested fields:
 
+Note the use of :manual:`dot notation </core/document/index.html#dot-notation>`
+in the ``address.city`` and ``address.country`` fields. Dot notation allows
+you to specify nested fields without writing separate lines for the top-level
+document and its sub-documents.
+
 .. code-block:: json
 
    {
@@ -189,21 +194,11 @@ The following is an example AVRO schema with nested fields:
          "type": "boolean"
        },
        {
-         "name": "address",
-         "type": {
-           "type": "record",
-           "name": "AddressRecord",
-           "fields": [
-             {
-               "name": "city",
-               "type": "string"
-             },
-             {
-               "name": "country",
-               "type": "string"
-             }
-           ]
-         }
+         "name": "address.city",
+         "type": "string"
+       { 
+         "name": "address.country",
+         "type": string"
        },
        {
          "name": "food",