improve description for analyzer training

Author: chienyuanchang

notebooks/analyzer_training.ipynb

@@ -60,7 +60,7 @@
    "metadata": {},
    "source": [
     "## Create Azure content understanding client\n",
-    "> The [AzureContentUnderstandingClient](../python/content_understanding_client.py) is utility Class which contain the functions to interact with the Content Understanding server. Before Content Understanding SDK release, we can regard it as a lightweight SDK. Fill the constant **AZURE_AI_ENDPOINT**, **AZURE_AI_API_VERSION**, **AZURE_AI_API_KEY** with the information from your Azure AI Service.\n",
+    "> The [AzureContentUnderstandingClient](../python/content_understanding_client.py) is utility class that contains the functions, Before the release of the Content Understanding SDK, please consider it a lightweight SDK., Fill in values for the constants **AZURE_AI_ENDPOINT**, **AZURE_AI_API_VERSION**, **AZURE_AI_API_KEY** with the information from your Azure AI Service.\n",
     "\n",
     "> ⚠️ Important:\n",
     "You must update the code below to match your Azure authentication method.\n",
@@ -111,9 +111,9 @@
    "metadata": {},
    "source": [
     "## Create analyzer with defined schema\n",
-    "Before creating the custom fields analyzer, you should fill the constant ANALYZER_ID with a business-related name. Here we randomly generate a name for demo purpose.\n",
+    "Before creating the analyzer, you should fill in the constant ANALYZER_ID with a relevant name to your task. Here, we generate a unique suffix so this cell can be run multiple times to create different analyzers.\n",
     "\n",
-    "We use **TRAINING_DATA_SAS_URL** and **TRAINING_DATA_PATH** that's set in the prerequisite step."
+    "We use **TRAINING_DATA_SAS_URL** and **TRAINING_DATA_PATH** that's set in the Prerequisites step."
    ]
   },
   {
@@ -133,11 +133,12 @@
     ")\n",
     "result = client.poll_result(response)\n",
     "if result is not None and \"status\" in result and result[\"status\"] == \"Succeeded\":\n",
-    "    logging.info(f\"Here is the analyzer detail for {result['result']['analyzerId']}\")\n",
+    "    logging.info(f\"Analyzer details for {result['result']['analyzerId']}\")\n",
     "    logging.info(json.dumps(result, indent=2))\n",
     "else:\n",
-    "    logging.info(\n",
-    "        \"Check your service please, may be some issues in configuration and deployment\"\n",
+    "    logging.warning(\n",
+    "        \"An issue was encountered when trying to create the analyzer. \"\n",
+    "        \"Please double-check your deployment and configurations for potential problems.\"\n",
     "    )"
    ]
   },
@@ -166,7 +167,7 @@
    "metadata": {},
    "source": [
     "## Delete exist analyzer in Content Understanding Service\n",
-    "This snippet is not required, but it's only used to prevent the testing analyzer from residing in your service. The custom fields analyzer could be stored in your service for reusing by subsequent business in real usage scenarios."
+    "This snippet is not required, but it's only used to prevent the testing analyzer from residing in your service. Without deletion, the analyzer will remain in your service for subsequent reuse."
    ]
   },
   {