Consumers of Preview APIs should have to explicitly enable the Previews they want

Open bitwiseman opened this issue 4 years ago • 1 comments

Related #1017 #1003

Currently, we mark preview APIs as deprecated. Instead we should require consumers to enable the specific Preview endpoints they want and by doing so they accept that those methods may change.

We can do this now. In v1, we can log warnings the first time a Preview endpoint is used without being enabled, but otherwise do not change behavior. For v2 we'll actually fail if a preview is used when it hasn't been enabled.

Jun 09 '21 21:06 bitwiseman

Almost all previews have be graduated. There is a new system for API versioning in GithHub. We will need to do something similar to this issue for the new scheme.

Nov 30 '23 18:11 bitwiseman