question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

[RFC] Experimental APIs

See original GitHub issue

In 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:open
  • Created 4 years ago
  • Reactions:22
  • Comments:37 (29 by maintainers)

github_iconTop GitHub Comments

38reactions
liachcommented, Feb 8, 2020

Quick vote: 👍 for guava @Beta annotation etc. in addition to @Deprecated on snapshot hooks 👎 for just @Deprecated on snapshot hooks

15reactions
liachcommented, Feb 9, 2020

Another quick note: We talked about jetbrain annotations has annotations like @ApiStatus.Experimental, which may serve notification purposes with ide integration.

Read more comments on GitHub >

github_iconTop 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 >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found