Skip to content
This repository was archived by the owner on Jul 10, 2025. It is now read-only.

Commit b275934

Browse files
alextpmartinwicke
authored andcommitted
clarifying known deficiency
1 parent c0929ea commit b275934

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

governance/api-reviews.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -227,7 +227,10 @@ to add an API with experimental in the name.)
227227

228228
No API with known deficiencies should be added to experimental. Experimental
229229
APIs should, to the best of our knowledge, not be expected to change in a known
230-
way (no argument with a known bad name, etc).
230+
way (no argument with a known bad name, etc). Experimental can, however, be used
231+
for APIs which are a work-in-progress: it's fine to add experimental methods to
232+
a base class even if those methods are only implemented on some subclasses as
233+
long as we expect all classes to eventually implement those.
231234

232235
The same amount of due diligence required for a real API is required for an
233236
experimental API: this means tests, benchmarks, documentation, end-to-end

0 commit comments

Comments
 (0)