Implement IDataStore about google-api-dotnet-client HOT 6 CLOSED

There are a few things in these libraries, that if we were to start over, we'd do differently. And IDataStore is likely one of those. At the moment we need to keep it as is for backwards compatibility reasons. That's not to say you are wrong, you are absolutely right that this is poorly documented.

I'll be sending a PR shortly to document how IDataStore should be implemented based on Google.Apis usage of it. And that should be semver future proof, which means, we may only change the interface itself or the expected behaviour as a breaking change in a new major version.

from google-api-dotnet-client.

I see. Thanks for the quick reply 👍

That being said, please consider introducing a new interface that is more intuitive, in a way that new users can use it, while making sure that IDataStore continues to work.

Although, I would argue to that breaking changes are sometimes good. That's what major version increments are for. If there is never a breaking change allowed, then the design will get worse and worse over time.

from google-api-dotnet-client.

These libraries are currently under maintenance mode, which means we are not planning on adding major features or make significant implementation changes. The libraries are very well supported and will continue to be so in the long term, but just don't expect any re-haul, including for major improvements. It's just a matter of capacity.

from google-api-dotnet-client.

BTW, see #2705, it's somewhat succint, but that's really all there is to it.

from google-api-dotnet-client.

I'm not sure I would consider this a major feature but that's up to you.

Stepping back, the fact that the .NET Google client library is in 'maintenance mode' really doesn't exactly inspire confidence or makes us want to bet further on Google APIs.

from google-api-dotnet-client.

Being in maintenance mode does not mean unsupported or abandoned. We continue to fix bugs, we continue to implement any and all features (including major work) required for these libraries to seemlessly work in/for the Google echosystem, and we continue to implement some other minor features and some other improvements. We'll continue to do so for the long term.

Bigger improvements, redesign work etc. is not being considered at the moment. The libraries are certainly not perfect, but we consider them to be mature and complete.

from google-api-dotnet-client.