Update see links from summary blocks of code comments (Azure#17825)

* Used "Update synonym map" as text for see-link (from page H1)

* Used "API versions in Azure Cognitive Search" as text for see-link (from page H1)

* Used "Document operations" as text for see-link (from page H1)

* Used "Count Documents" as text for see-link (from page H1)

* Used "Update Data Source" as text for see-link (from page H1)

* Used "Indexer operations" as text for see-link (from page H1)

* Used "Create Indexer" as text for see-link (from page H1)

* Used "How to index JSON blobs using a Blob indexer in Azure Cognitive Search" as text for see-link (from page H1)

* Used "How to index CSV blobs using delimitedText parsing mode and Blob indexers in Azure Cognitive Search" as text for see-link (from page H1)

* Used the H2 title without the "class" prefix and with the suffix "(Lucene API)" as text for see-links

* Fixed documentation summer links for various `<see>` entries to include link text

* Reverted changes to any files with _generated_ in the path

* Reverted Microsoft.Azure.Search.* changes

* Some docs still have invisible links, eg https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.search.documentsoperationsextensions

* Re-trigger the CI test

* Removed trailing white-space

Author: gnabgib

sdk/search/Azure.Search.Documents/src/Indexes/Models/LexicalAnalyzerName.cs

@@ -186,17 +186,17 @@ public static class Values
             public const string ViMicrosoft = LexicalAnalyzerName.ViMicrosoftValue;
             /// <summary> Standard Lucene analyzer. </summary>
             public const string StandardLucene = LexicalAnalyzerName.StandardLuceneValue;
-            /// <summary> Standard ASCII Folding Lucene analyzer. See https://docs.microsoft.com/rest/api/searchservice/Custom-analyzers-in-Azure-Search#Analyzers. </summary>
+            /// <summary> Standard ASCII Folding Lucene analyzer. See <see href="https://docs.microsoft.com/rest/api/searchservice/Custom-analyzers-in-Azure-Search#Analyzers">Add custom analyzers to string fields in an Azure Cognitive Search index</see>. </summary>
             public const string StandardAsciiFoldingLucene = LexicalAnalyzerName.StandardAsciiFoldingLuceneValue;
-            /// <summary> Treats the entire content of a field as a single token. This is useful for data like zip codes, ids, and some product names. See http://lucene.apache.org/core/4_10_3/analyzers-common/org/apache/lucene/analysis/core/KeywordAnalyzer.html. </summary>
+            /// <summary> Treats the entire content of a field as a single token. This is useful for data like zip codes, ids, and some product names. See <see href="http://lucene.apache.org/core/4_10_3/analyzers-common/org/apache/lucene/analysis/core/KeywordAnalyzer.html">KeywordAnalyzer (Lucene API)</see>. </summary>
             public const string Keyword = LexicalAnalyzerName.KeywordValue;
-            /// <summary> Flexibly separates text into terms via a regular expression pattern. See http://lucene.apache.org/core/4_10_3/analyzers-common/org/apache/lucene/analysis/miscellaneous/PatternAnalyzer.html. </summary>
+            /// <summary> Flexibly separates text into terms via a regular expression pattern. See <see href="http://lucene.apache.org/core/4_10_3/analyzers-common/org/apache/lucene/analysis/miscellaneous/PatternAnalyzer.html">PatternAnalyzer (Lucene API)</see>. </summary>
             public const string Pattern = LexicalAnalyzerName.PatternValue;
-            /// <summary> Divides text at non-letters and converts them to lower case. See http://lucene.apache.org/core/4_10_3/analyzers-common/org/apache/lucene/analysis/core/SimpleAnalyzer.html. </summary>
+            /// <summary> Divides text at non-letters and converts them to lower case. See <see href="http://lucene.apache.org/core/4_10_3/analyzers-common/org/apache/lucene/analysis/core/SimpleAnalyzer.html">SimpleAnalyzer (Lucene API)</see>. </summary>
             public const string Simple = LexicalAnalyzerName.SimpleValue;
-            /// <summary> Divides text at non-letters; Applies the lowercase and stopword token filters. See http://lucene.apache.org/core/4_10_3/analyzers-common/org/apache/lucene/analysis/core/StopAnalyzer.html. </summary>
+            /// <summary> Divides text at non-letters; Applies the lowercase and stopword token filters. See <see href="http://lucene.apache.org/core/4_10_3/analyzers-common/org/apache/lucene/analysis/core/StopAnalyzer.html">StopAnalyzer (Lucene API)</see>. </summary>
             public const string Stop = LexicalAnalyzerName.StopValue;
-            /// <summary> An analyzer that uses the whitespace tokenizer. See http://lucene.apache.org/core/4_10_3/analyzers-common/org/apache/lucene/analysis/core/WhitespaceAnalyzer.html. </summary>
+            /// <summary> An analyzer that uses the whitespace tokenizer. See <see href="http://lucene.apache.org/core/4_10_3/analyzers-common/org/apache/lucene/analysis/core/WhitespaceAnalyzer.html">WhitespaceAnalyzer (Lucene API)</see>. </summary>
             public const string Whitespace = LexicalAnalyzerName.WhitespaceValue;
         }
 #pragma warning restore CA1034 // Nested types should not be visible

sdk/search/Azure.Search.Documents/src/SearchClientOptions.cs

@@ -20,7 +20,8 @@ public class SearchClientOptions : ClientOptions
         /// <summary>
         /// The versions of Azure Cognitive Search supported by this client
         /// library.  For more, see
-        /// <see href="https://docs.microsoft.com/azure/search/search-api-versions" />.
+        /// <see href="https://docs.microsoft.com/azure/search/search-api-versions">
+        /// API versions in Azure Cognitive Search</see>.
         /// </summary>
         public enum ServiceVersion
         {
@@ -48,7 +49,8 @@ public enum ServiceVersion
         /// <summary>
         /// Gets the <see cref="ServiceVersion"/> of the service API used when
         /// making requests.  For more, see
-        /// <see href="https://docs.microsoft.com/azure/search/search-api-versions" />.
+        /// <see href="https://docs.microsoft.com/azure/search/search-api-versions">
+        /// API versions in Azure Cognitive Search</see>.
         /// </summary>
         public ServiceVersion Version { get; }
 
@@ -67,7 +69,8 @@ public enum ServiceVersion
         /// <param name="version">
         /// An optional <see cref="ServiceVersion"/> to specify the version of
         /// the REST API to use.  For more, see
-        /// <see href="https://docs.microsoft.com/azure/search/search-api-versions" />.
+        /// <see href="https://docs.microsoft.com/azure/search/search-api-versions">
+        /// API versions in Azure Cognitive Search</see>.
         ///
         /// If not provided, the <paramref name="version"/> will default to the
         /// latest supported by this client library.  It is recommended that

sdk/storage/Azure.Storage.Blobs/src/BlobClient.cs

@@ -222,7 +222,8 @@ internal BlobClient(
         /// class with an identical <see cref="Uri"/> source but the specified
         /// <paramref name="snapshot"/> timestamp.
         ///
-        /// For more information, see <see href="https://docs.microsoft.com/en-us/rest/api/storageservices/creating-a-snapshot-of-a-blob" />.
+        /// For more information, see <see href="https://docs.microsoft.com/en-us/rest/api/storageservices/creating-a-snapshot-of-a-blob">
+        /// Create a snapshot of a blob</see>.
         /// </summary>
         /// <param name="snapshot">The snapshot identifier.</param>
         /// <returns>A new <see cref="BlobClient"/> instance.</returns>

sdk/storage/Azure.Storage.Blobs/src/BlobLeaseClient.cs

@@ -145,7 +145,8 @@ private void EnsureClient()
         /// using the active lease ID as <see cref="LeaseId"/>, but you can
         /// specify a new <paramref name="duration"/>.
         ///
-        /// For more information, see <see href="https://docs.microsoft.com/rest/api/storageservices/lease-container" />.
+        /// For more information, see <see href="https://docs.microsoft.com/rest/api/storageservices/lease-container">
+        /// Lease Container</see>.
         /// </summary>
         /// <param name="duration">
         /// Specifies the duration of the lease, in seconds, or specify

sdk/storage/Azure.Storage.Files.DataLake/src/DataLakeClientOptions.cs

@@ -67,7 +67,8 @@ public enum ServiceVersion
         /// <summary>
         /// Gets the <see cref="ServiceVersion"/> of the service API used when
         /// making requests.  For more, see
-        /// <see href="https://docs.microsoft.com/en-us/rest/api/storageservices/versioning-for-the-azure-storage-services" />.
+        /// <see href="https://docs.microsoft.com/en-us/rest/api/storageservices/versioning-for-the-azure-storage-services">
+        /// Versioning for the Azure Storage services</see>.
         /// </summary>
         public ServiceVersion Version { get; }
 

sdk/tables/Azure.Data.Tables/src/Sas/TableSasBuilder.cs

@@ -10,7 +10,8 @@ namespace Azure.Data.Tables.Sas
     /// <summary>
     /// <see cref="TableSasBuilder"/> is used to generate a Shared Access
     /// Signature (SAS) for an Azure Storage table.
-    /// For more information, see <see href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-account-sas" />.
+    /// For more information, see <see href="https://docs.microsoft.com/en-us/rest/api/storageservices/create-account-sas">
+    /// Constructing an Account SAS</see>.
     /// </summary>
     public class TableSasBuilder
     {