[CLU] support for AAD + docs

sdk/cognitivelanguage/azure-ai-language-conversations/CHANGELOG.md

@@ -10,7 +10,7 @@
 * Client now uses python dictionaries for method parameters and results instead of classes.
 * Many input and result parameter name changes in `analyze_conversation()` method
 
-## 1.0.0 (Unreleased)
+## 1.0.0 (2022-06-27)
 
 ### Features Added
 * Added Azure Active Directory (AAD) authentication support

sdk/cognitivelanguage/azure-ai-language-conversations/README.md

@@ -6,7 +6,7 @@ Conversational Language Understanding - aka **CLU** for short - is a cloud-based
 - Workflow app: Acts like an orchestrator to select the best candidate to analyze conversations to get best response from apps like Qna, Luis, and Conversation App
 
 
-[Source code][conversationallanguage_client_src] | [Package (PyPI)][conversationallanguage_pypi_package] | [API reference documentation][api_reference_documentation] | [Product documentation][conversationallanguage_docs] | [Samples][conversationallanguage_samples]
+[Source code][conversationallanguage_client_src] | [Package (PyPI)][conversationallanguage_pypi_package] | [API reference documentation][api_reference_documentation] | [Samples][conversationallanguage_samples] | [Product documentation][conversationallanguage_docs] | [Analysis REST API documentation][conversationanalysis_restdocs] | [Authoring REST API documentation][conversationanalysis_restdocs_authoring]
 
 ## _Disclaimer_
 
@@ -370,7 +370,8 @@ This project has adopted the [Microsoft Open Source Code of Conduct][code_of_con
 [azure_cli]: https://docs.microsoft.com/cli/azure/
 [azure_portal]: https://portal.azure.com/
 [azure_subscription]: https://azure.microsoft.com/free/
-
+[conversationanalysis_restdocs]: https://docs.microsoft.com/rest/api/language/conversation-analysis-runtime/
+[conversationanalysis_restdocs_authoring]: https://docs.microsoft.com/rest/api/language/conversational-analysis-authoring
 [cla]: https://cla.microsoft.com
 [coc_contact]: mailto:[email protected]
 [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/

sdk/cognitivelanguage/azure-ai-language-conversations/azure/ai/language/conversations/_operations/_patch.py

@@ -12,7 +12,10 @@
 
 ConversationAnalysisClientOperationsMixinGenerated.analyze_conversation.__doc__ = \
     """Analyzes the input conversation utterance.
-
+
+    See https://docs.microsoft.com/rest/api/language/conversation-analysis-runtime/analyze-conversation
+    for more information.
+
     :param task: A single conversational task to execute. Is either a model type or a IO type.
      Required.
     :type task: JSON or IO

sdk/cognitivelanguage/azure-ai-language-conversations/azure/ai/language/conversations/_patch.py

@@ -58,6 +58,9 @@ class ConversationAnalysisClient(GeneratedConversationAnalysisClient): # pylint:
     the best candidate service to handle the request. At last, it returns a response with the
     candidate service's response as a payload.
 
+    See https://docs.microsoft.com/rest/api/language/conversation-analysis-runtime/ for more information about
+    requests and responses you can pass to this client.
+
     :param endpoint: Supported Cognitive Services endpoint (e.g.,
      https://:code:`<resource-name>`.cognitiveservices.azure.com). Required.
     :type endpoint: str

sdk/cognitivelanguage/azure-ai-language-conversations/azure/ai/language/conversations/aio/_operations/_patch.py

@@ -13,6 +13,9 @@
 ConversationAnalysisClientOperationsMixinGenerated.analyze_conversation.__doc__ = \
     """Analyzes the input conversation utterance.
 
+    See https://docs.microsoft.com/rest/api/language/conversation-analysis-runtime/analyze-conversation
+    for more information.
+
     :param task: A single conversational task to execute. Is either a model type or a IO type.
      Required.
     :type task: JSON or IO

sdk/cognitivelanguage/azure-ai-language-conversations/azure/ai/language/conversations/aio/_patch.py

@@ -59,6 +59,9 @@ class ConversationAnalysisClient(GeneratedConversationAnalysisClient): # pylint:
     the best candidate service to handle the request. At last, it returns a response with the
     candidate service's response as a payload.
 
+    See https://docs.microsoft.com/rest/api/language/conversation-analysis-runtime/ for more information about
+    requests and responses you can pass to this client.
+
     :param endpoint: Supported Cognitive Services endpoint (e.g.,
      https://:code:`<resource-name>`.cognitiveservices.azure.com). Required.
     :type endpoint: str

sdk/cognitivelanguage/azure-ai-language-conversations/azure/ai/language/conversations/authoring/_patch.py

@@ -35,6 +35,9 @@ class ConversationAuthoringClient(GeneratedConversationAuthoringClient): # pylin
     detection and question answering. Further documentation can be found in
     https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/overview.
 
+    See https://docs.microsoft.com/rest/api/language/conversational-analysis-authoring for more information about
+    requests and responses you can pass to this client.
+
     :param endpoint: Supported Cognitive Services endpoint (e.g.,
      https://:code:`<resource-name>`.cognitiveservices.azure.com). Required.
     :type endpoint: str