search

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

Use proper brand names in Search README #11749

Closed heaths closed 4 years ago

heaths commented 4 years ago

We need to decide on whether to use proper branding names in the Search README.

We could probably resolve this for preview 4, but, @HeidiSteen, since "Search" is a product name shouldn't this be "Search" or even "Azure Search" (or maybe "Azure Cognitive Search") per branding guidelines (I had to do quite a bit of these changes back in the day for .NET and Visual Studio, including on my formerly popular blog - they were pretty serious).

Originally posted by @heaths in https://github.com/Azure/azure-sdk-for-net/pull/11748

HeidiSteen commented 4 years ago

The original service name was "Azure Search", but it was rebranded last October to "Azure Cognitive Search" (full). Because the rebranding is new, I always use the full name, but I sometimes see PMs and other contributors using the short form: "Cognitive Search". I personally think that looks too close to Cognitive Services so I don't use it.

Lower-casing stuff: "service" is always lower case. If you want to make a generic reference to a search service (for example, when referring to the customer's search service), lower case the "s" in "search" also.

Do: Azure Cognitive Search, Cognitive Search, search service Don't: Azure Search, Search service, Search Service

heaths commented 4 years ago

I've verified in the places Ted changed that we do refer to a customer's search service, so closing.