DOCSP-48400-confusion-multi-shard-key (#732) (#742)

shuangela · web-flow · commit 8737738761fb · 2025-04-29T10:55:05.000-04:00
* add explaination * condense wording * add source and destination (cherry picked from commit 9734cd3)
diff --git a/source/includes/intro-start-api-example-intro.rst b/source/includes/intro-start-api-example-intro.rst
@@ -1,3 +1,2 @@
-The following example starts a sync job between ``cluster0`` and
-``cluster1``.  The source cluster is ``cluster0`` and the destination
-cluster is ``cluster1``.
+The following example starts a sync job between the source cluster ``cluster0`` and the
+destination cluster ``cluster1``.
diff --git a/source/reference/api/start.txt b/source/reference/api/start.txt
@@ -365,6 +365,10 @@ Response:
 Start Sync from Replica Set to Sharded Cluster
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+The following example starts a sync job between the source replica set ``cluster0`` and the
+destination sharded cluster ``cluster1``. The ``key`` array in this example defines the shard key
+``{"location": 1, "region": 1 }``.
+
 Request:
 
 .. literalinclude:: /includes/api/requests/start-rs-shard.sh
