Azure / azure-sdk-for-net

This repository is for active development of the Azure SDK for .NET. For consumers of the SDK we recommend visiting our public developer docs at https://learn.microsoft.com/dotnet/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-net.
MIT License
5.47k stars 4.8k forks source link

sdk/search/README.md lists track 2 as "preview", fully documents track 1 #13781

Closed heaths closed 4 years ago

heaths commented 4 years ago

I'm not sure how much we rely on README.md in the service client roots, but I see that sdk/search/README.md currently reads,

Functionality is exposed through several client libraries:

- [Azure.Search.Documents](./Azure.Search.Documents/) is a preview experience
  built on top of [Azure.Core](../core/Azure.Core/README.md) and the
  [Azure SDK Design Guidelines for .NET](https://azure.github.io/azure-sdk/dotnet_introduction.html).

- [Microsoft.Azure.Search](./Microsoft.Azure.Search/) is the officially
supported .NET client library that makes it easy to develop applications using
Azure Cognitive Search.  The `Microsoft.Azure.Search` package includes the
following client libraries:
  - [Microsoft.Azure.Search.Data](./Microsoft.Azure.Search.Data/) enables

Note track 2 reads "a preview experience". We should at least update that, if not downplay track 1.

tg-msft commented 4 years ago

Also need to change the links in the Azure.Search.Documents readme per https://github.com/Azure/azure-sdk-for-python/pull/12894