This can be solved by adding some sort of annotation or documentation to new api's. In RxJava [1], parts of the API are marked with @Experimental or @Beta. @Ex

This can be solved by adding some sort of annotation or documentation to new api's. In RxJava [1], parts of the API are marked with @Experimental or @Beta. @Experimental provides no guarantees, while @Beta only guarantees no breakage in the same minor version. [1] https://github.com/ReactiveX/RxJava https://github.com/ReactiveX/RxJava