update readme and samples (Azure#35198)

* update readme  and samples

* set changelog date

* Prepare-Release

* fix SDK Version format

Author: asaflevi-ms

sdk/healthinsights/Azure.Health.Insights.CancerProfiling/CHANGELOG.md

@@ -1,12 +1,7 @@
 # Release History
 
-## 1.0.0-beta.1 (Unreleased)
+## 1.0.0-beta.1 (2023-04-11)
 
 ### Features Added
 - Initial preview of the Azure.Health.Insights.CancerProfiling client library.
 
-### Breaking Changes
-
-### Bugs Fixed
-
-### Other Changes

sdk/healthinsights/Azure.Health.Insights.CancerProfiling/README.md

@@ -1,10 +1,11 @@
 # Azure Cognitive Services Health Insights Cancer Profiling client library for .NET
 
-<!-- [Health Insights](https://review.learn.microsoft.com/en-us/azure/cognitive-services/health-decision-support/overview?branch=main) is an Azure Applied AI Service built with the Azure Cognitive Services Framework, that leverages multiple Cognitive Services, Healthcare API services and other Azure resources.
-The [Cancer Profiling model](https://review.learn.microsoft.com/en-us/azure/cognitive-services/health-decision-support/oncophenotype/overview?branch=main) receives clinical records of oncology patients and outputs cancer staging, such as clinical stage TNM categories and pathologic stage TNM categories as well as tumor site, histology. -->
+[Health Insights](https://review.learn.microsoft.com/azure/azure-health-insights/?branch=release-azure-health-insights) is an Azure Applied AI Service built with the Azure Cognitive Services Framework, that leverages multiple Cognitive Services, Healthcare API services and other Azure resources.
+
+The [Cancer Profiling model][cancer_profiling_docs] receives clinical records of oncology patients and outputs cancer staging, such as clinical stage TNM categories and pathologic stage TNM categories as well as tumor site, histology.
+
+[Source code][cancer_profiling_client_src] | [Package (NuGet)][cancer_profiling_client_nuget_package] | [API reference documentation][cancer_profiling_api_documentation] | [Product documentation][product_docs]
 
-[Health Insights] is an Azure Applied AI Service built with the Azure Cognitive Services Framework, that leverages multiple Cognitive Services, Healthcare API services and other Azure resources.
-The [Cancer Profiling model] receives clinical records of oncology patients and outputs cancer staging, such as clinical stage TNM categories and pathologic stage TNM categories as well as tumor site, histology.
 
 ## Getting started
 
@@ -25,13 +26,11 @@ This table shows the relationship between SDK versions and supported API version
 
 |SDK version|Supported API version of service |
 |-------------|---------------|
-|1.0.0b1 | 2023-03-01-preview|
+|1.0.0-beta.1 | 2023-03-01-preview|
 
 ### Authenticate the client
 
-You can find the endpoint for your Health Insights service resource using the
-[Azure Portal](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesHealthInsights)
-or [Azure CLI](https://learn.microsoft.com/cli/azure/):
+You can find the endpoint for your Health Insights service resource using the [Azure Portal][azure_portal] or [Azure CLI][azure_cli]
 
 ```bash
 # Get the endpoint for the Health Insights service resource
@@ -58,18 +57,12 @@ var credential = new AzureKeyCredential(apiKey);
 var client = new CancerProfilingClient(new Uri(endpoint), credential);
 ```
 
-### Long-Running Operations
-
-For large documents which take a long time to execute, these operations are implemented as [**long-running operations**][dotnet_lro]. Long-running operations consist of an initial request sent to the service to start an operation, followed by polling the service at intervals to determine whether the operation has completed or failed, and if it has succeeded, to get the result.
-
-For long running operations in the Azure SDK, the client exposes a `Start<operation-name>` method that returns an `Operation<T>` or a `PageableOperation<T>`.  You can use the extension method `WaitForCompletionAsync()` to wait for the operation to complete and obtain its result.  A sample code snippet is provided to illustrate using long-running operations [below](#run-multiple-actions-asynchronously).
-
 ## Key concepts
 The Cancer Profiling model allows you to infer cancer attributes such as tumor site, histology, clinical stage TNM categories and pathologic stage TNM categories from unstructured clinical documents.
 
 ## Examples
 
-- [Infer Cancer Profiling](#cancer-profiling)
+- [Infer Cancer Profiling][samples_location]
 
 ### Cancer Profiling
 
@@ -140,14 +133,9 @@ To learn more about other logging mechanisms see [Diagnostics Samples][logging].
 
 ## Next steps
 
-<!-- These code samples show common scenario operations with the Azure health Insights Cancer Profiling library. More samples can be found under the [samples](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/tests/Samples/) directory.
+## Additional documentation
 
-- Infer Cancer Profile: [Sample_InferCancerProfile.cs](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/tests/Samples/Sample_InferCancerProfile.cs) -->
-
-
-### Additional documentation
-
-<!-- For more extensive documentation on Azure Health Insights Cancer Profiling, see the [Cancer Profiling documentation](https://review.learn.microsoft.com/en-us/azure/cognitive-services/health-decision-support/oncophenotype/overview?branch=main) on docs.microsoft.com. -->
+For more extensive documentation on Azure Health Insights Cancer Profiling, see the [Cancer Profiling documentation][cancer_profiling_docs] on docs.microsoft.com.
 
 ## Contributing
 
@@ -158,18 +146,20 @@ When you submit a pull request, a CLA-bot will automatically determine whether y
 This project has adopted the [Microsoft Open Source Code of Conduct][code_of_conduct]. For more information see the [Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any additional questions or comments.
 
 <!-- LINKS -->
-[cancer_profiling_client_class]:
- <!-- https://github.com/Azure/azure-sdk-for-net/tree/main/
-sdk/healthinsights/Azure.Health.Insights.CancerProfiling/src/Generated/CancerProfilingClient.cs -->
-
-[DefaultAzureCredential]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/identity/Azure.Identity/README.md
-[cognitive_resource_cli]: https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli
+[cancer_profiling_client_src]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/src/
+[cancer_profiling_client_nuget_package]: https://www.nuget.org/packages/
+[cancer_profiling_api_documentation]: https://review.learn.microsoft.com/rest/api/cognitiveservices/healthinsights/onco-phenotype?branch=healthin202303
+[cancer_profiling_client_class]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/src/Generated/CancerProfilingClient.cs
+[samples_location]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/samples
 [logging]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/core/Azure.Core/samples/Diagnostics.md
 [azure_cli]: https://docs.microsoft.com/cli/azure
-[azure_sub]: https://azure.microsoft.com/free/dotnet/
+[azure_sub
+]: https://azure.microsoft.com/free/dotnet/
 [nuget]: https://www.nuget.org/
-[azure_portal]: https://portal.azure.com
+[azure_portal]: https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesHealthInsights
 [cla]: https://cla.microsoft.com
 [code_of_conduct]: https://opensource.microsoft.com/codeofconduct/
 [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
 [coc_contact]: mailto:opencode@microsoft.com
+[cancer_profiling_docs]: https://review.learn.microsoft.com/azure/cognitive-services/health-decision-support/oncophenotype/overview?branch=main
+[product_docs]:https://review.learn.microsoft.com/azure/cognitive-services/health-decision-support/oncophenotype/?branch=main

sdk/healthinsights/Azure.Health.Insights.CancerProfiling/samples/README.md

@@ -19,8 +19,6 @@ These code samples show common scenario operations with the Azure Health Insight
 |[Sample01_InferCancerProfileAsync][sample_get_the_inferred_cancer_staging_for_an_oncology_patient_async] |Get the inferred cancer staging for an oncology patient (Async).|
 
 
-<!-- LINKS
 [sample_get_the_inferred_cancer_staging_for_an_oncology_patient_async]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/samples/Sample01_InferCancerProfile.md
 [sample_get_the_inferred_cancer_staging_for_an_oncology_patient]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/samples/Sample01_InferCancerProfileAsync.md
--->
 

sdk/healthinsights/Azure.Health.Insights.CancerProfiling/samples/Sample01_InferCancerProfile.md

@@ -1,6 +1,8 @@
 # Get the inferred cancer staging for an oncology patient
 This sample demonstrates how to get the inferred cancer staging, such as pTNM staging and histology codes, for an oncology patient, based on his/her clinical documents (medical records), and to review the clinical evidence for each inference, extracted from these documents.
 
+To get started, make sure you have satisfied all the prerequisites and got all the resources required by [README][README].
+
 ## Creating a `CancerProfilingClient`
 
 To create a new `CancerProfilingClient` to get the inferred cancer staging, you need a Cognitive Services endpoint and credentials. You can use the [DefaultAzureCredential][DefaultAzureCredential] to try a number of common authentication methods optimized for both running as a service and development.  In the sample below, however, you'll use a AzureHealthInsights service API key credential by creating an `AzureKeyCredential` object, that if needed, will allow you to update the API key without creating a new client.
@@ -194,3 +196,5 @@ else
     }
 }
 ```
+<!-- Links -->
+[README]:https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/README.md

sdk/healthinsights/Azure.Health.Insights.CancerProfiling/samples/Sample01_InferCancerProfileAsync.md

@@ -1,6 +1,8 @@
 # Get the inferred cancer staging for an oncology patient
 This sample demonstrates how to get the inferred cancer staging, such as pTNM staging and histology codes, for an oncology patient, based on his/her clinical documents (medical records), and to review the clinical evidence for each inference, extracted from these documents.
 
+To get started, make sure you have satisfied all the prerequisites and got all the resources required by [README][README].
+
 ## Creating a `CancerProfilingClient`
 
 To create a new `CancerProfilingClient` to get the inferred cancer staging, you need a Cognitive Services endpoint and credentials. You can use the [DefaultAzureCredential][DefaultAzureCredential] to try a number of common authentication methods optimized for both running as a service and development.  In the sample below, however, you'll use a AzureHealthInsights service API key credential by creating an `AzureKeyCredential` object, that if needed, will allow you to update the API key without creating a new client.
@@ -194,3 +196,7 @@ else
     }
 }
 ```
+
+
+<!-- Links -->
+[README]:https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/README.md

sdk/healthinsights/Azure.Health.Insights.CancerProfiling/src/Azure.Health.Insights.CancerProfiling.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <Description>This is the Azure Health Insights CancerProfiling client library for developing .NET applications with rich experience.</Description>
     <AssemblyTitle>Azure SDK Code Generation HealthInsights for Azure Data Plane</AssemblyTitle>

sdk/healthinsights/Azure.Health.Insights.CancerProfiling/tests/Samples/README.md

@@ -1,5 +1,4 @@
 Source files in this directory are written as tests from which samples are extracted.
 They are not intended to be viewed directly and help ensure our samples compile and work correctly.
-<!-- LINKS 
-See our [list of samples](https://github.com/Azure/azure-sdk-for-net-pr/tree/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/samples) for more explanation about how to use this client library.
--->
+
+See our [list of samples](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/samples) for more explanation about how to use this client library.

sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/CHANGELOG.md

@@ -1,12 +1,7 @@
 # Release History
 
-## 1.0.0-beta.1 (Unreleased)
+## 1.0.0-beta.1 (2023-04-11)
 
 ### Features Added
 - Initial preview of the Azure.Health.Insights.ClinicalMatching client library.
 
-### Breaking Changes
-
-### Bugs Fixed
-
-### Other Changes

sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/README.md

@@ -1,10 +1,11 @@
 # Azure Cognitive Services Health Insights Clinical Matching client library for .NET
-<!--
-[Health Insights](https://review.learn.microsoft.com/en-us/azure/cognitive-services/health-decision-support/overview?branch=main) is an Azure Applied AI Service built with the Azure Cognitive Services Framework, that leverages multiple Cognitive Services, Healthcare API services and other Azure resources.
-The [Clinical Matching model](https://review.learn.microsoft.com/en-us/azure/cognitive-services/health-decision-support/trial-matcher/overview?branch=main) receives patients data and clinical trials protocols, and provides relevant clinical trials based on eligibility criteria. -->
 
-[Health Insights] is an Azure Applied AI Service built with the Azure Cognitive Services Framework, that leverages multiple Cognitive Services, Healthcare API services and other Azure resources.
-The [Clinical Matching model] receives patients data and clinical trials protocols, and provides relevant clinical trials based on eligibility criteria.
+[Health Insights](https://review.learn.microsoft.com/azure/cognitive-services/health-decision-support/overview?branch=main) is an Azure Applied AI Service built with the Azure Cognitive Services Framework, that leverages multiple Cognitive Services, Healthcare API services and other Azure resources.
+
+The [Clinical Matching model][clinical_matching_docs] receives patients data and clinical trials protocols, and provides relevant clinical trials based on eligibility criteria.
+
+[Source code][clinical_matching_client_src] | [Package (NuGet)][clinical_matching_client_nuget_package] | [API reference documentation][clinical_matching_api_documentation] | [Product documentation][product_docs]
+
 
 ## Getting started
 
@@ -25,13 +26,11 @@ This table shows the relationship between SDK versions and supported API version
 
 |SDK version|Supported API version of service |
 |-------------|---------------|
-|1.0.0b1 | 2023-03-01-preview|
+|1.0.0-beta.1 | 2023-03-01-preview|
 
 ### Authenticate the client
 
-You can find the endpoint for your Health Insights service resource using the
-[Azure Portal](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesHealthInsights)
-or [Azure CLI](https://learn.microsoft.com/cli/azure/):
+You can find the endpoint for your Health Insights service resource using the [Azure Portal][azure_portal] or [Azure CLI][azure_cli]
 
 ```bash
 # Get the endpoint for the Health Insights service resource
@@ -58,12 +57,6 @@ var credential = new AzureKeyCredential(apiKey);
 var client = new ClinicalMatchingClient(new Uri(endpoint), credential);
 ```
 
-### Long-Running Operations
-
-For large documents which take a long time to execute, these operations are implemented as [**long-running operations**][dotnet_lro]. Long-running operations consist of an initial request sent to the service to start an operation, followed by polling the service at intervals to determine whether the operation has completed or failed, and if it has succeeded, to get the result.
-
-For long running operations in the Azure SDK, the client exposes a `Start<operation-name>` method that returns an `Operation<T>` or a `PageableOperation<T>`.  You can use the extension method `WaitForCompletionAsync()` to wait for the operation to complete and obtain its result.  A sample code snippet is provided to illustrate using long-running operations [below](#run-multiple-actions-asynchronously).
-
 ## Key concepts
 Trial Matcher provides the user of the services two main modes of operation: patients centric and clinical trial centric.
 
@@ -72,7 +65,7 @@ Trial Matcher provides the user of the services two main modes of operation: pat
 
 ## Examples
 
-- [Match Trials](#match-trials)
+- [Match Trials][samples_location]
 
 ### Match Trials
 
@@ -133,14 +126,9 @@ To learn more about other logging mechanisms see [Diagnostics Samples][logging].
 
 ## Next steps
 
-<!-- These code samples show common scenario operations with the Azure health Insights Clinical Matching library. More samples can be found under the [samples](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/tests/Samples/) directory.
-
-- Match Trials: [Sample_MatchTrials.cs](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/tests/Samples/Sample_MatchTrials.cs) -->
-
+## Additional documentation
 
-### Additional documentation
-
-<!-- For more extensive documentation on Azure Health Insights Clinical Matching, see the [Clinical Matching documentation](https://review.learn.microsoft.com/en-us/azure/cognitive-services/health-decision-support/trial-matcher/?branch=main) on docs.microsoft.com. -->
+For more extensive documentation on Azure Health Insights Clinical Matching, see the [Clinical Matching documentation][clinical_matching_docs] on docs.microsoft.com.
 
 ## Contributing
 
@@ -151,9 +139,7 @@ When you submit a pull request, a CLA-bot will automatically determine whether y
 This project has adopted the [Microsoft Open Source Code of Conduct][code_of_conduct]. For more information see the [Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any additional questions or comments.
 
 <!-- LINKS -->
-[clinical_matching_client_class]:
-<!-- https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/src/Generated/ClinicalMatchingClient.cs -->
-
+[clinical_matching_client_class]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/src/Generated/ClinicalMatchingClient.cs
 [DefaultAzureCredential]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/identity/Azure.Identity/README.md
 [cognitive_resource_cli]: https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli
 [logging]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/core/Azure.Core/samples/Diagnostics.md
@@ -164,4 +150,10 @@ This project has adopted the [Microsoft Open Source Code of Conduct][code_of_con
 [cla]: https://cla.microsoft.com
 [code_of_conduct]: https://opensource.microsoft.com/codeofconduct/
 [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
-[coc_contact]: mailto:opencode@microsoft.com -->
+[coc_contact]: mailto:opencode@microsoft.com
+[clinical_matching_docs]: https://review.learn.microsoft.com/azure/cognitive-services/health-decision-support/trial-matcher/overview?branch=main
+[clinical_matching_client_src]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/src/
+[clinical_matching_client_nuget_package]: https://www.nuget.org/packages/
+[clinical_matching_api_documentation]: https://review.learn.microsoft.com/rest/api/cognitiveservices/healthinsights/trial-matcher?branch=healthin202303
+[product_docs]:https://review.learn.microsoft.com/azure/cognitive-services/health-decision-support/trial-matcher/?branch=main
+[samples_location]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/samples

sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/samples/README.md

@@ -17,7 +17,7 @@ These code samples show common scenario operations with the Azure Health Insight
 |----------------|-------------|
 |[Sample01_MatchTrials][sample_get_all_matching_clinical_trials_for_a_specific_patient] |Get all matching clinical trials for a specific patient. (sync)|
 |[Sample01_MatchTrialsAsync][sample_get_all_matching_clinical_trials_for_a_specific_patient_async] |Get all matching clinical trials for a specific patient. (async)|
-<!-- LINKS
+
+<!-- LINKS -->
 [sample_get_all_matching_clinical_trials_for_a_specific_patient]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/samples/Sample01_MatchTrials.md
 [sample_get_all_matching_clinical_trials_for_a_specific_patient_async]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/samples/Sample01_MatchTrialsAsync.md
--->