There are 2 comments.
 
 
OpenId Connect / cid:jira-generated-image-avatar-fb37e734-8ec2-4eba-8cb5-02de84954e72 OIDC-218 Closed

Add @Unstable annotations on new APIs of the oauth2 client

 
View issue   ยท   Add comment
 

2 comments

 
cid:jira-generated-image-avatar-d48b780c-9759-421d-a2c2-1cb35fc89ee7 Thomas Mortagne on 28/Mar/25 09:16
 

Yes, using @Unstable the way we do in XWiki Standard (so for each new API) does not make sense for a contrib extension (unless the contrib extension has the clear release and stabilization cycle, which is not the case here).

The only way it makes sense is when you know some API is not finished, you are still working on it and have a clear deadline (or at least a set of criteria) to decide when you plan to remove that annotation (and document that in the extension page for example). But maybe it's the case here ?

 
cid:jira-generated-image-avatar-d48b780c-9759-421d-a2c2-1cb35fc89ee7 Thomas Mortagne on 28/Mar/25 09:16
 
Yes, using @Unstable the way we do in XWiki Standard (so for each new API) does not make sense for a contrib extension (unless the contrib extension has the a clear release and stabilization cycle, which is not the case here).

The only way it makes sense is when you know some API is not finished, you are still working on it and have a clear deadline (or at least a set of criteria) to decide when you plan to remove that annotation (and document that in the extension page for example). But maybe it's the case here ?