Add a section in the README about Cloud APIs

[omaray]

Given that many users will end up on this README, we need to let them know that for Google Cloud APIs, they need to visit the google-cloud-dotnet repository instead. We can add a section towards the top in the main README that says the following:

Google Cloud Platform APIs

If you're working with Google Cloud Platform APIs such as Datastore or Pub/Sub, consider using the Cloud Client Libraries for .NET instead. These are the new and idiomatic .NET libraries targeted specifically at Google Cloud Platform Services.

[LindaLawton]

In the five years I have been contributing on this library; I don't think we have ever had someone post an issue with the cloud library here. So I am going to have to disagree with the statement.

Many users will end up on this README

Also I don't think we need to tell people they may be in the wrong place. README's tell people about where they are, and do not try to guess where they possibly should be. If that were the case we should add a section to point everyone to the correct API forums we regularly get people coming here with API related issues.

[omaray]

Thanks Linda for the comment and your contributions.

We've ran many user studies and developers will many times end up on these repos (the Google APIs Client repos) and try and use the libraries they see here. In theory this would be fine, but we've have built new libraries for Google Cloud Platform specifically, and many users actually asked that we make it clear where they should go.

So this how we let them know about the other libraries. And this is not just a comment done in passage: the request came in many times.

Best.

[LindaLawton]

@omaray I hope you didn't take my comment personally. This is just my opinion. The Googlers working on the project decide which issues we address and which ones we don't . I don't have control over that. I just give my opinion when I feel it's needed.

I believe the documentation points to the correct repos and we haven't had any issues posted here that I am aware of.

I am curious as to the target of your user study was? When Google runs a study I tend to be contacted. As you are Google I bow to your Googlieness.