Currently we use a JavaDoc tag "hv.experimental" to flag experimental/incubating APIs/SPIs. Using a proper annotation makes it easier for users to spot used incubating things (you can search for references in the IDE and also the generated JavaDocs will contain a list of all incubating members).