Package org.apache.pekko.annotation

Annotation Interface ApiMayChange

@Documented @Retention(CLASS) @Target({METHOD,CONSTRUCTOR,FIELD,TYPE,PACKAGE}) public @interface ApiMayChange
Marks APIs that are meant to evolve towards becoming stable APIs, but are not stable APIs yet.

Evolving interfaces MAY change from one patch release to another (i.e. 2.4.10 to 2.4.11) without up-front notice. A best-effort approach is taken to not cause more breakage than really necessary, and usual deprecation techniques are utilised while evolving these APIs, however there is NO strong guarantee regarding the source or binary compatibility of APIs marked using this annotation.

It MAY also change when promoting the API to stable, for example such changes may include removal of deprecated methods that were introduced during the evolution and final refactoring that were deferred because they would have introduced to much breaking changes during the evolution phase.

Promoting the API to stable MAY happen in a patch release.

It is encouraged to document in ScalaDoc how exactly this API is expected to evolve.

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    String
    issue
    Reference to issue discussing the future evolvement of this API

  • Element Details

    • issue

      String issue
      Reference to issue discussing the future evolvement of this API
      Default:
      ""