[
https://issues.apache.org/jira/browse/OAK-11871?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18015470#comment-18015470
]
Julian Reschke commented on OAK-11871:
--------------------------------------
FWIW, I believe I can answer what is *not* public - it's anything annotated
with
https://www.javadoc.io/doc/org.apache.jackrabbit/oak-commons/latest/org/apache/jackrabbit/oak/commons/annotations/Internal.html
> Expand oak/docs/participating vs API changes
> --------------------------------------------
>
> Key: OAK-11871
> URL: https://issues.apache.org/jira/browse/OAK-11871
> Project: Jackrabbit Oak
> Issue Type: Improvement
> Components: doc
> Reporter: Julian Reschke
> Assignee: Julian Reschke
> Priority: Minor
>
> I would like to expand Expand oak/docs/participating to discuss API changes a
> bit more:
> # Recommend that an API change gets at least one approval from committers
> familiar with package versioning.
> # Warn against minor version changes as well.
> # Mention the "@Internal" annotation.
> # Recommend not to extend public (non-internal) APIs unless it's clear that
> the new API will be needed outside Oak.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
