Merge pull request #280413 from seesharprun/cosmos-remove-html-comments

Cosmos DB | Remove HTML comments from articles (1/2)

Author: prmerger-automator[bot]

articles/cosmos-db/nosql/manage-with-powershell.md

@@ -831,8 +831,6 @@ Remove-AzResourceLock `
 * [Create an Azure Cosmos DB container](how-to-create-container.md)
 * [Configure time-to-live in Azure Cosmos DB](how-to-time-to-live.md)
 
-<!--Reference style links - using these makes the source content way more readable than using inline links-->
-
 [powershell-install-configure]: /powershell/azure/
 [scaling-globally]: ../distribute-data-globally.md#EnableGlobalDistribution
 [distribute-data-globally]: ../distribute-data-globally.md

articles/cosmos-db/nosql/samples-java.md

@@ -176,12 +176,6 @@ The [Collection CRUD Samples](https://github.com/Azure/azure-documentdb-java/blo
 | Exclude specified documents paths from the index | [IndexingPolicy.ExcludedPaths](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/src/main/java/com/azure/cosmos/examples/indexmanagement/sync/SampleIndexManagement.java#L148-L151) |
 | Create a composite index | [IndexingPolicy.setCompositeIndexes](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/src/main/java/com/azure/cosmos/examples/indexmanagement/sync/SampleIndexManagement.java#L167-L184) <br> CompositePath |
 | Create a geospatial index | [IndexingPolicy.setSpatialIndexes](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/src/main/java/com/azure/cosmos/examples/indexmanagement/sync/SampleIndexManagement.java#L153-L165) <br> SpatialSpec <br> SpatialType |
-<!-- | Exclude a document from the index | ExcludedIndex<br>IndexingPolicy | -->
-<!-- | Use Lazy Indexing | IndexingPolicy.IndexingMode | -->
-<!-- | Force a range scan operation on a hash indexed path | FeedOptions.EnableScanInQuery | -->
-<!-- | Use range indexes on Strings | IndexingPolicy.IncludedPaths<br>RangeIndex | -->
-<!-- | Perform an index transform | - | -->
-
 
 For more information about indexing, see [Azure Cosmos DB indexing policies](../index-policy.md).
 
@@ -204,7 +198,6 @@ The Query Samples files for [sync](https://github.com/Azure-Samples/azure-cosmos
 | Query with parameterized SQL using SqlQuerySpec | [CosmosContainer.queryItems](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/src/main/java/com/azure/cosmos/examples/queries/sync/QueriesQuickstart.java#L387-L416) <br> [CosmosAsyncContainer.queryItems](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/0ead4ca33dac72c223285e1db866c9dc06f5fb47/src/main/java/com/azure/cosmos/examples/queries/async/QueriesQuickstartAsync.java#L426-L455)|
 | Query with explicit paging | [CosmosContainer.queryItems](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/src/main/java/com/azure/cosmos/examples/queries/sync/QueriesQuickstart.java#L211-L261) <br>  [CosmosAsyncContainer.queryItems](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/0ead4ca33dac72c223285e1db866c9dc06f5fb47/src/main/java/com/azure/cosmos/examples/queries/async/QueriesQuickstartAsync.java#L250-L300)|
 | Query partitioned collections in parallel | [CosmosContainer.queryItems](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/src/main/java/com/azure/cosmos/examples/queries/sync/QueriesQuickstart.java#L263-L284) <br> [CosmosAsyncContainer.queryItems](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/0ead4ca33dac72c223285e1db866c9dc06f5fb47/src/main/java/com/azure/cosmos/examples/queries/async/QueriesQuickstartAsync.java#L302-L323)|
-<!-- | Query with ORDER BY for partitioned collections | CosmosContainer.queryItems <br> CosmosAsyncContainer.queryItems | -->
 
 ## Change feed examples 
 The [Change Feed Processor Sample](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/src/main/java/com/azure/cosmos/examples/changefeed/SampleChangeFeedProcessor.java) file shows how to do the following tasks. To learn about change feed in Azure Cosmos DB before you run the following samples, see [Read Azure Cosmos DB change feed](read-change-feed.md) and [Change feed processor](/azure/cosmos-db/sql/change-feed-processor?tabs=java).
@@ -213,7 +206,6 @@ The [Change Feed Processor Sample](https://github.com/Azure-Samples/azure-cosmos
 | --- | --- |
 | Basic change feed functionality | [ChangeFeedProcessor.changeFeedProcessorBuilder](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/src/main/java/com/azure/cosmos/examples/changefeed/SampleChangeFeedProcessor.java#L141-L172) |
 | Read change feed from the beginning | [ChangeFeedProcessorOptions.setStartFromBeginning()](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/0ead4ca33dac72c223285e1db866c9dc06f5fb47/src/main/java/com/azure/cosmos/examples/changefeed/SampleChangeFeedProcessor.java#L65) |
-<!-- | Read change feed from a specific time | ChangeFeedProcessor.changeFeedProcessorBuilder | -->
 
 ## Server-side programming examples
 
@@ -225,15 +217,6 @@ The [Stored Procedure Sample](https://github.com/Azure-Samples/azure-cosmos-java
 | Execute a stored procedure | [CosmosStoredProcedure.execute](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/src/main/java/com/azure/cosmos/examples/storedprocedure/sync/SampleStoredProcedure.java#L213-L227) |
 | Delete a stored procedure | [CosmosStoredProcedure.delete](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/src/main/java/com/azure/cosmos/examples/storedprocedure/sync/SampleStoredProcedure.java#L254-L264) |
 
-<!-- ## User management examples
-The User Management Sample file shows how to do the following tasks:
-
-| Task | API reference |
-| --- | --- |
-| Create a user | - |
-| Set permissions on a collection or document | - |
-| Get a list of a user's permissions |- | -->
-
 ## Next steps
 
 Trying to do capacity planning for a migration to Azure Cosmos DB? You can use information about your existing database cluster for capacity planning.

articles/cosmos-db/nosql/troubleshoot-dotnet-sdk.md

@@ -93,7 +93,6 @@ If you encounter the following error: `Unable to load DLL 'Microsoft.Azure.Cosmo
 * Learn about Performance guidelines for the [.NET SDK](performance-tips-dotnet-sdk-v3.md)
 * Learn about the best practices for the [.NET SDK](best-practice-dotnet.md)
 
- <!--Anchors-->
 [Common issues and workarounds]: #common-issues-workarounds
 [Azure SNAT (PAT) port exhaustion]: #snat
 [Production check list]: #production-check-list

articles/cosmos-db/nosql/troubleshoot-java-async-sdk.md

@@ -278,7 +278,6 @@ The number of connections to the Azure Cosmos DB endpoint in the `ESTABLISHED` s
 
 Many connections to the Azure Cosmos DB endpoint might be in the `CLOSE_WAIT` state. There might be more than 1,000. A number that high indicates that connections are established and torn down quickly. This situation potentially causes problems. For more information, see the [Common issues and workarounds] section.
 
- <!--Anchors-->
 [Common issues and workarounds]: #common-issues-workarounds
 [Enable client SDK logging]: #enable-client-sice-logging
 [Connection limit on a host machine]: #connection-limit-on-host

articles/cosmos-db/nosql/troubleshoot-java-sdk-v4.md

@@ -500,7 +500,6 @@ The [query metrics](query-metrics.md) will help determine where the query is spe
 * Learn about Performance guidelines for the [Java SDK v4](performance-tips-java-sdk-v4.md)
 * Learn about the best practices for the [Java SDK v4](best-practice-java.md)
 
- <!--Anchors-->
 [Common issues and workarounds]: #common-issues-workarounds
 [Enable client SDK logging]: #enable-client-sice-logging
 [Connection limit on a host machine]: #connection-limit-on-host