search

QuiltMC / rfcs

Repository for requests for comments for proposing changes to the Quilt Project.
Other
61 stars 33 forks source link

Amendment to RFC 9: Add experimental features. #12

Closed Redblueflame closed 3 years ago

Redblueflame commented 3 years ago

Rendered

Everything needed for the initial RFC is here, but there will be more to explain in a separate RFC once this one is merged, and working groups are ready.

Reasoning

Experimental features are really needed to prevent incrementing the major / minor version every time a change is made to the user facing APIs, and allow for staged testing before a general availability.

This system is used successfully in rust's standard library, and bring safety for developers, that are sure of the quality of each function called.

i509VCB commented 3 years ago

Would probably be good to note that @ApiStatus.Experimental and @Deprecated should both be applied to apis so IDE notification works out.

Redblueflame commented 3 years ago

Would probably be good to note that @ApiStatus.Experimental and @Deprecated should both be applied to apis so IDE notification works out.

True, but isn't it a little bit too close to the implementation for the scope of this amendment? I'm currently working on a separate RFC for the specifics of the experimental status, in addition to all the other lifetimes.

TheGlitch76 commented 3 years ago

Yeah, let's keep the annotation stuff to RFC 13, which formally defines the implementation of experimental features.