[RFC] Experimental APIs
See original GitHub issueIn order to support API features that are likely to change (1.16 nether biome selection) or difficult to get right from the start, I am proposing to offer experimental APIs in Fabric API. Those APIs are marked via @Deprecated
and can both extend existing modules or form new ones.
The @Deprecated
annotation use is in line with how Java annotates its preview features, which serve a similar purpose. Additionally the associated Javadoc has to include @deprecated Experimental feature, may be removed or changed without further notice <optional explanation why it is experimental>
.
Addition of and incompatible changes to experimental features will incur a minor version bump, the major version and module version (v0/v1/…) remain the same.
Issue Analytics
- State:
- Created 4 years ago
- Reactions:22
- Comments:37 (29 by maintainers)
Top Results From Across the Web
RFC 2614 - An API for Service Location - IETF Datatracker
An API for Service Location (RFC 2614) ... NAs are used for private definitions of well known Service Types and experimental Service Type...
Read more >RFC 7046: A Common API for Transparent Hybrid Multicast
RFC 7046 Common Mcast API December 2013 Status of This Memo This document is ... This document defines an Experimental Protocol for the...
Read more >RFC 3338: Dual Stack Hosts Using "Bump-in-the-API" (BIA) - hjp
Network Working Group S. Lee Request for Comments: 3338 M-K. Shin Category: Experimental Y-J. Kim ETRI E. Nordmark A. Durand Sun Microsystems October...
Read more >API Lifecycle — Zephyr Project Documentation
Experimental APIs denote that a feature was introduced recently, ... The RFC issue must be submitted for discussion in the next Zephyr API...
Read more >RFC | etcd
The page that you are viewing is the last archived version. For the latest stable documentation, see v3.5. Versions · v3.1 · RFC....
Read more >Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start FreeTop Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
Top GitHub Comments
Quick vote: 👍 for guava
@Beta
annotation etc. in addition to@Deprecated
on snapshot hooks 👎 for just@Deprecated
on snapshot hooksAnother quick note: We talked about jetbrain annotations has annotations like
@ApiStatus.Experimental
, which may serve notification purposes with ide integration.