diff --git a/specification/communication/data-plane/JobRouter/preview/2022-07-18-preview/communicationservicejobrouter.json b/specification/communication/data-plane/JobRouter/preview/2022-07-18-preview/communicationservicejobrouter.json
index d99cf4f070b0..2be2857afdbf 100644
--- a/specification/communication/data-plane/JobRouter/preview/2022-07-18-preview/communicationservicejobrouter.json
+++ b/specification/communication/data-plane/JobRouter/preview/2022-07-18-preview/communicationservicejobrouter.json
@@ -23,7 +23,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the classification policy",
+            "description": "Id of the classification policy.",
             "required": true,
             "type": "string"
           },
@@ -33,7 +33,7 @@
           {
             "in": "body",
             "name": "patch",
-            "description": "Model of classification policy properties to be patched. See also: https://datatracker.ietf.org/doc/html/rfc7386",
+            "description": "Model of classification policy properties to be patched. See also: https://datatracker.ietf.org/doc/html/rfc7386.",
             "required": true,
             "schema": {
               "$ref": "#/definitions/ClassificationPolicy"
@@ -73,7 +73,7 @@
         "tags": [
           "ClassificationPolicies"
         ],
-        "summary": "Retrieves an existing classification policy by Id",
+        "summary": "Retrieves an existing classification policy by Id.",
         "operationId": "JobRouterAdministration_GetClassificationPolicy",
         "produces": [
           "application/json"
@@ -82,7 +82,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the classification policy",
+            "description": "Id of the classification policy.",
             "required": true,
             "type": "string"
           },
@@ -114,7 +114,7 @@
         "tags": [
           "ClassificationPolicies"
         ],
-        "summary": "Delete a classification policy by Id",
+        "summary": "Delete a classification policy by Id.",
         "operationId": "JobRouterAdministration_DeleteClassificationPolicy",
         "produces": [
           "application/json"
@@ -123,7 +123,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the classification policy",
+            "description": "Id of the classification policy.",
             "required": true,
             "type": "string"
           },
@@ -154,7 +154,7 @@
         "tags": [
           "ClassificationPolicies"
         ],
-        "summary": "Retrieves existing classification policies",
+        "summary": "Retrieves existing classification policies.",
         "operationId": "JobRouterAdministration_ListClassificationPolicies",
         "produces": [
           "application/json"
@@ -163,7 +163,7 @@
           {
             "in": "query",
             "name": "maxpagesize",
-            "description": "Maximum page size",
+            "description": "Maximum page size.",
             "type": "integer",
             "format": "int32"
           },
@@ -213,7 +213,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the distribution policy",
+            "description": "Id of the distribution policy.",
             "required": true,
             "type": "string"
           },
@@ -223,7 +223,7 @@
           {
             "in": "body",
             "name": "patch",
-            "description": "Model of distribution policy properties to be patched. See also: https://datatracker.ietf.org/doc/html/rfc7386",
+            "description": "Model of distribution policy properties to be patched. See also: https://datatracker.ietf.org/doc/html/rfc7386.",
             "required": true,
             "schema": {
               "$ref": "#/definitions/DistributionPolicy"
@@ -263,7 +263,7 @@
         "tags": [
           "DistributionPolicies"
         ],
-        "summary": "Retrieves an existing distribution policy by Id",
+        "summary": "Retrieves an existing distribution policy by Id.",
         "operationId": "JobRouterAdministration_GetDistributionPolicy",
         "produces": [
           "application/json"
@@ -272,7 +272,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the distribution policy",
+            "description": "Id of the distribution policy.",
             "required": true,
             "type": "string"
           },
@@ -304,7 +304,7 @@
         "tags": [
           "DistributionPolicies"
         ],
-        "summary": "Delete a distribution policy by Id",
+        "summary": "Delete a distribution policy by Id.",
         "operationId": "JobRouterAdministration_DeleteDistributionPolicy",
         "produces": [
           "application/json"
@@ -313,7 +313,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the distribution policy",
+            "description": "Id of the distribution policy.",
             "required": true,
             "type": "string"
           },
@@ -344,7 +344,7 @@
         "tags": [
           "DistributionPolicies"
         ],
-        "summary": "Retrieves existing distribution policies",
+        "summary": "Retrieves existing distribution policies.",
         "operationId": "JobRouterAdministration_ListDistributionPolicies",
         "produces": [
           "application/json"
@@ -353,7 +353,7 @@
           {
             "in": "query",
             "name": "maxpagesize",
-            "description": "Maximum page size",
+            "description": "Maximum page size.",
             "type": "integer",
             "format": "int32"
           },
@@ -403,7 +403,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the exception policy",
+            "description": "Id of the exception policy.",
             "required": true,
             "type": "string"
           },
@@ -453,7 +453,7 @@
         "tags": [
           "ExceptionPolicies"
         ],
-        "summary": "Retrieves an existing exception policy by Id",
+        "summary": "Retrieves an existing exception policy by Id.",
         "operationId": "JobRouterAdministration_GetExceptionPolicy",
         "produces": [
           "application/json"
@@ -462,7 +462,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the exception policy to retrieve",
+            "description": "Id of the exception policy to retrieve.",
             "required": true,
             "type": "string"
           },
@@ -494,7 +494,7 @@
         "tags": [
           "ExceptionPolicies"
         ],
-        "summary": "Deletes a exception policy by Id",
+        "summary": "Deletes a exception policy by Id.",
         "operationId": "JobRouterAdministration_DeleteExceptionPolicy",
         "produces": [
           "application/json"
@@ -503,7 +503,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the exception policy to delete",
+            "description": "Id of the exception policy to delete.",
             "required": true,
             "type": "string"
           },
@@ -534,7 +534,7 @@
         "tags": [
           "ExceptionPolicies"
         ],
-        "summary": "Retrieves existing exception policies",
+        "summary": "Retrieves existing exception policies.",
         "operationId": "JobRouterAdministration_ListExceptionPolicies",
         "produces": [
           "application/json"
@@ -543,7 +543,7 @@
           {
             "in": "query",
             "name": "maxpagesize",
-            "description": "Number of objects to return per page",
+            "description": "Number of objects to return per page.",
             "type": "integer",
             "format": "int32"
           },
@@ -646,7 +646,7 @@
         "tags": [
           "Jobs"
         ],
-        "summary": "Retrieves an existing job by Id",
+        "summary": "Retrieves an existing job by Id.",
         "operationId": "JobRouter_GetJob",
         "produces": [
           "application/json"
@@ -655,7 +655,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the job to retrieve",
+            "description": "Id of the job to retrieve.",
             "required": true,
             "type": "string"
           },
@@ -696,7 +696,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the job",
+            "description": "Id of the job.",
             "required": true,
             "type": "string"
           },
@@ -739,7 +739,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the job",
+            "description": "Id of the job.",
             "required": true,
             "type": "string"
           },
@@ -793,7 +793,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the job",
+            "description": "Id of the job.",
             "required": true,
             "type": "string"
           },
@@ -803,7 +803,7 @@
           {
             "in": "body",
             "name": "cancelJobRequest",
-            "description": "Request model for cancelling job",
+            "description": "Request model for cancelling job.",
             "schema": {
               "$ref": "#/definitions/CancelJobRequest"
             },
@@ -848,7 +848,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the job",
+            "description": "Id of the job.",
             "required": true,
             "type": "string"
           },
@@ -858,7 +858,7 @@
           {
             "in": "body",
             "name": "completeJobRequest",
-            "description": "Request model for completing job",
+            "description": "Request model for completing job.",
             "required": true,
             "schema": {
               "$ref": "#/definitions/CompleteJobRequest"
@@ -904,7 +904,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the job",
+            "description": "Id of the job.",
             "required": true,
             "type": "string"
           },
@@ -914,7 +914,7 @@
           {
             "in": "body",
             "name": "closeJobRequest",
-            "description": "Request model for closing job",
+            "description": "Request model for closing job.",
             "required": true,
             "schema": {
               "$ref": "#/definitions/CloseJobRequest"
@@ -954,7 +954,7 @@
         "tags": [
           "Jobs"
         ],
-        "summary": "Retrieves list of jobs based on filter parameters",
+        "summary": "Retrieves list of jobs based on filter parameters.",
         "operationId": "JobRouter_ListJobs",
         "produces": [
           "application/json"
@@ -1008,7 +1008,7 @@
           {
             "in": "query",
             "name": "scheduledBefore",
-            "description": "If specified, filter on jobs that was scheduled before or at given timestamp. Range: (-Inf, scheduledBefore]",
+            "description": "If specified, filter on jobs that was scheduled before or at given timestamp. Range: (-Inf, scheduledBefore].",
             "type": "string",
             "format": "date-time"
           },
@@ -1022,7 +1022,7 @@
           {
             "in": "query",
             "name": "maxpagesize",
-            "description": "Number of objects to return per page",
+            "description": "Number of objects to return per page.",
             "type": "integer",
             "format": "int32"
           },
@@ -1069,7 +1069,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the job",
+            "description": "Id of the job.",
             "required": true,
             "type": "string"
           },
@@ -1115,14 +1115,14 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the job to un-assign",
+            "description": "Id of the job to un-assign.",
             "required": true,
             "type": "string"
           },
           {
             "in": "path",
             "name": "assignmentId",
-            "description": "Id of the assignment to un-assign",
+            "description": "Id of the assignment to un-assign.",
             "required": true,
             "type": "string"
           },
@@ -1132,7 +1132,7 @@
           {
             "in": "body",
             "name": "unassignJobRequest",
-            "description": "Request body for unassign route",
+            "description": "Request body for unassign route.",
             "schema": {
               "$ref": "#/definitions/UnassignJobRequest"
             }
@@ -1173,14 +1173,14 @@
           {
             "in": "path",
             "name": "workerId",
-            "description": "Id of the worker",
+            "description": "Id of the worker.",
             "required": true,
             "type": "string"
           },
           {
             "in": "path",
             "name": "offerId",
-            "description": "Id of the offer",
+            "description": "Id of the offer.",
             "required": true,
             "type": "string"
           },
@@ -1226,14 +1226,14 @@
           {
             "in": "path",
             "name": "workerId",
-            "description": "Id of the worker",
+            "description": "Id of the worker.",
             "required": true,
             "type": "string"
           },
           {
             "in": "path",
             "name": "offerId",
-            "description": "Id of the offer",
+            "description": "Id of the offer.",
             "required": true,
             "type": "string"
           },
@@ -1243,7 +1243,7 @@
           {
             "in": "body",
             "name": "declineJobOfferRequest",
-            "description": "Request model for declining offer",
+            "description": "Request model for declining offer.",
             "schema": {
               "$ref": "#/definitions/DeclineJobOfferRequest"
             }
@@ -1287,7 +1287,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the queue",
+            "description": "Id of the queue.",
             "required": true,
             "type": "string"
           },
@@ -1297,7 +1297,7 @@
           {
             "in": "body",
             "name": "patch",
-            "description": "Model of queue properties to be patched. See also: https://datatracker.ietf.org/doc/html/rfc7386",
+            "description": "Model of queue properties to be patched. See also: https://datatracker.ietf.org/doc/html/rfc7386.",
             "required": true,
             "schema": {
               "$ref": "#/definitions/RouterQueue"
@@ -1337,7 +1337,7 @@
         "tags": [
           "Queues"
         ],
-        "summary": "Retrieves an existing queue by Id",
+        "summary": "Retrieves an existing queue by Id.",
         "operationId": "JobRouterAdministration_GetQueue",
         "produces": [
           "application/json"
@@ -1346,7 +1346,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the queue to retrieve",
+            "description": "Id of the queue to retrieve.",
             "required": true,
             "type": "string"
           },
@@ -1378,7 +1378,7 @@
         "tags": [
           "Queues"
         ],
-        "summary": "Deletes a queue by Id",
+        "summary": "Deletes a queue by Id.",
         "operationId": "JobRouterAdministration_DeleteQueue",
         "produces": [
           "application/json"
@@ -1387,7 +1387,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the queue to delete",
+            "description": "Id of the queue to delete.",
             "required": true,
             "type": "string"
           },
@@ -1418,7 +1418,7 @@
         "tags": [
           "Queues"
         ],
-        "summary": "Retrieves existing queues",
+        "summary": "Retrieves existing queues.",
         "operationId": "JobRouterAdministration_ListQueues",
         "produces": [
           "application/json"
@@ -1427,7 +1427,7 @@
           {
             "in": "query",
             "name": "maxpagesize",
-            "description": "Number of objects to return per page",
+            "description": "Number of objects to return per page.",
             "type": "integer",
             "format": "int32"
           },
@@ -1465,7 +1465,7 @@
         "tags": [
           "Queues"
         ],
-        "summary": "Retrieves a queue's statistics",
+        "summary": "Retrieves a queue's statistics.",
         "operationId": "JobRouter_GetQueueStatistics",
         "produces": [
           "application/json"
@@ -1474,7 +1474,7 @@
           {
             "in": "path",
             "name": "id",
-            "description": "Id of the queue to retrieve statistics",
+            "description": "Id of the queue to retrieve statistics.",
             "required": true,
             "type": "string"
           },
@@ -1520,7 +1520,7 @@
           {
             "in": "path",
             "name": "workerId",
-            "description": "Id of the worker",
+            "description": "Id of the worker.",
             "required": true,
             "type": "string"
           },
@@ -1530,7 +1530,7 @@
           {
             "in": "body",
             "name": "patch",
-            "description": "Model of worker properties to be created or patched. See also: https://datatracker.ietf.org/doc/html/rfc7386",
+            "description": "Model of worker properties to be created or patched. See also: https://datatracker.ietf.org/doc/html/rfc7386.",
             "required": true,
             "schema": {
               "$ref": "#/definitions/RouterWorker"
@@ -1579,7 +1579,7 @@
         "tags": [
           "Workers"
         ],
-        "summary": "Retrieves an existing worker by Id",
+        "summary": "Retrieves an existing worker by Id.",
         "operationId": "JobRouter_GetWorker",
         "produces": [
           "application/json"
@@ -1588,7 +1588,7 @@
           {
             "in": "path",
             "name": "workerId",
-            "description": "Id of the worker to retrieve",
+            "description": "Id of the worker to retrieve.",
             "required": true,
             "type": "string"
           },
@@ -1629,7 +1629,7 @@
           {
             "in": "path",
             "name": "workerId",
-            "description": "Id of the worker to delete",
+            "description": "Id of the worker to delete.",
             "required": true,
             "type": "string"
           },
@@ -1686,25 +1686,25 @@
           {
             "in": "query",
             "name": "channelId",
-            "description": "If specified, select workers who have a channel configuration with this channel",
+            "description": "If specified, select workers who have a channel configuration with this channel.",
             "type": "string"
           },
           {
             "in": "query",
             "name": "queueId",
-            "description": "If specified, select workers who are assigned to this queue",
+            "description": "If specified, select workers who are assigned to this queue.",
             "type": "string"
           },
           {
             "in": "query",
             "name": "hasCapacity",
-            "description": "If set to true, select only workers who have capacity for the channel specified by `channelId` or for any channel\r\n            if `channelId` not specified. If set to false, then will return all workers including workers without any capacity for jobs. Defaults to false.",
+            "description": "If set to true, select only workers who have capacity for the channel specified by `channelId` or for any channel if `channelId` not specified. If set to false, then will return all workers including workers without any capacity for jobs. Defaults to false.",
             "type": "boolean"
           },
           {
             "in": "query",
             "name": "maxpagesize",
-            "description": "Number of objects to return per page",
+            "description": "Number of objects to return per page.",
             "type": "integer",
             "format": "int32"
           },
@@ -1778,6 +1778,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing BestWorkerMode",
           "type": "string"
         },
         "scoringRule": {
@@ -1799,10 +1800,11 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing CancelExceptionAction",
           "type": "string"
         },
         "note": {
-          "description": "(Optional) A note that will be appended to the jobs' Notes collection with th current timestamp.",
+          "description": "(Optional) A note that will be appended to the jobs' Notes collection with the current timestamp.",
           "maxLength": 2000,
           "minLength": 0,
           "type": "string"
@@ -2009,6 +2011,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing ConditionalQueueSelectorAttachment",
           "type": "string"
         },
         "condition": {
@@ -2038,6 +2041,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing ConditionalWorkerSelectorAttachment",
           "type": "string"
         },
         "condition": {
@@ -2079,6 +2083,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing DirectMapRouterRule",
           "type": "string"
         }
       },
@@ -2282,6 +2287,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing ExpressionRouterRule",
           "type": "string"
         },
         "language": {
@@ -2317,6 +2323,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing FunctionRouterRule",
           "type": "string"
         },
         "functionUri": {
@@ -2355,10 +2362,11 @@
       }
     },
     "JobMatchingMode": {
-      "description": "",
+      "description": "The matching mode to be applied to this job.\r\n            \r\nSupported types:\r\n            \r\nQueueAndMatchMode: Used when matching worker to a job is required to be done right after job is queued.\r\nScheduleAndSuspendMode: Used for scheduling jobs to be queued at a future time. At specified time, matching of a worker to the job will not start automatically.\r\nSuspendMode: Used when matching workers to a job needs to be suspended.",
       "type": "object",
       "properties": {
         "modeType": {
+          "description": "Discriminator value used to differentiate between supported matching mode types.",
           "enum": [
             "queueAndMatchMode",
             "scheduleAndSuspendMode",
@@ -2391,6 +2399,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing LongestIdleMode",
           "type": "string"
         }
       },
@@ -2406,6 +2415,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing ManualReclassifyExceptionAction",
           "type": "string"
         },
         "queueId": {
@@ -2461,6 +2471,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing PassThroughQueueSelectorAttachment",
           "type": "string"
         },
         "key": {
@@ -2502,6 +2513,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing PassThroughWorkerSelectorAttachment",
           "type": "string"
         },
         "key": {
@@ -2535,7 +2547,7 @@
       "x-ms-discriminator-value": "pass-through"
     },
     "QueueAndMatchMode": {
-      "description": "",
+      "description": "Describes a matching mode where matching worker to a job is automatically started after job is queued successfully.",
       "type": "object"
     },
     "QueueLengthExceptionTrigger": {
@@ -2551,6 +2563,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing a sub-type of QueueLengthExceptionTrigger",
           "type": "string"
         },
         "threshold": {
@@ -2607,6 +2620,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing ReclassifyExceptionAction.",
           "type": "string"
         },
         "classificationPolicyId": {
@@ -2642,6 +2656,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing RoundRobinMode",
           "type": "string"
         }
       },
@@ -3053,6 +3068,7 @@
       "type": "object",
       "properties": {
         "id": {
+          "description": "Id of the worker.",
           "type": "string",
           "readOnly": true
         },
@@ -3268,6 +3284,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing RuleEngineQueueSelectorAttachment",
           "type": "string"
         },
         "rule": {
@@ -3289,6 +3306,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing RuleEngineWorkerSelectorAttachment",
           "type": "string"
         },
         "rule": {
@@ -3298,10 +3316,12 @@
       "x-ms-discriminator-value": "rule-engine"
     },
     "ScheduleAndSuspendMode": {
+      "description": "Describes a matching mode used for scheduling jobs to be queued at a future time.\r\nAt the specified time, matching worker to a job will not start automatically.",
       "type": "object",
       "properties": {
         "scheduleAt": {
           "format": "date-time",
+          "description": "Scheduled time.",
           "type": "string"
         }
       }
@@ -3354,6 +3374,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing StaticQueueSelectorAttachment",
           "type": "string"
         },
         "queueSelector": {
@@ -3372,6 +3393,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing StaticRouterRule",
           "type": "string"
         },
         "value": {
@@ -3396,6 +3418,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing StaticWorkerSelectorAttachment",
           "type": "string"
         },
         "workerSelector": {
@@ -3405,6 +3428,7 @@
       "x-ms-discriminator-value": "static"
     },
     "SuspendMode": {
+      "description": "Describes a matching mode where matching worker to a job is suspended.",
       "type": "object"
     },
     "UnassignJobRequest": {
@@ -3412,7 +3436,7 @@
       "type": "object",
       "properties": {
         "suspendMatching": {
-          "description": "If WaitForActivation is true, then the job is not queued for re-matching with a worker.",
+          "description": "If SuspendMatching is true, then the job is not queued for re-matching with a worker.",
           "type": "boolean"
         }
       }
@@ -3450,6 +3474,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing a sub-type of WaitTimeExceptionTrigger",
           "type": "string"
         },
         "thresholdSeconds": {
@@ -3470,6 +3495,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing WebhookRouterRule",
           "type": "string"
         },
         "authorizationServerUri": {
@@ -3501,6 +3527,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing WeightedAllocationQueueSelectorAttachment",
           "type": "string"
         },
         "allocations": {
@@ -3526,6 +3553,7 @@
       ],
       "properties": {
         "kind": {
+          "description": "The type discriminator describing WeightedAllocationWorkerSelectorAttachment",
           "type": "string"
         },
         "allocations": {