experimental API policy

[alextp]

No description provided.

[karmel]

As a user, some questions I would have:

1. How will this be enforced?
2. I was using the experimental ABC API, and it was non-compliant because of XYZ. Why did that happen?What recourse do I have?

[alextp]

1. How will this be enforced?

By the same API review process we use to enforce our other API policies? Or did you mean something else (like: "will we write tools to introspect into these APIs?", to which the answer is yes, soon)

2. I was using the experimental ABC API, and it was non-compliant because of XYZ. Why did that happen?What recourse do I have?

I think this policy says that we cannot remove experimental APIs that break people without a lot of warning (or at all, if we cannot find a good replacement), so it's on us to fix noncompliant APIs as much as we can.

[alextp]

No, external contributors can contribute to tf.experimental too.

…

On Mon, Apr 6, 2020 at 9:31 AM bhack ***@***.***> wrote: ***@***.**** commented on this pull request. ------------------------------ In governance/api-reviews.md <#218 (comment)>: > + +No API with known deficiencies should be added to experimental. Experimental +APIs should, to the best of our knowledge, not be expected to change in a known +way (no argument with a known bad name, etc). Experimental can, however, be used +for APIs which are a work-in-progress: it's fine to add experimental methods to +a base class even if those methods are only implemented on some subclasses as +long as we expect all classes to eventually implement those. + +The same amount of due diligence required for a real API is required for an +experimental API: this means tests, benchmarks, documentation, end-to-end +examples, etc + +Experimental APIs are not a license to break users. This means: + 1. we do not remove experimental APIs which are widely used without an effort + to help migrate users away + 2. experimental APIs are not removed without warning and don't have Ok but it is still not clear to me if an external contributor need to contribute in tf.exeperimental or in tfa. Is this tf.foo.experimetnal policy reserved to Google employee? — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#218 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAABHRNGJW2WQCYYUJS5IDTRLH7W3ANCNFSM4LMPCH6A> .

-- - Alex

[lc0]

I think this makes it more clear - thanks!