+1

On Tue, Sep 20, 2016 at 10:24 AM, Vincent Massol <vinc...@massol.net> wrote:
> Hi devs,
>
> I’d like to propose that we standardized on using multiple @since tags for 
> multiple versions in order to be more semantic and not have to invent a 
> syntax (that then needs to be followed and parsed)
>
> Instead of:
>
> @since 8.4.5, 8.3RC1
>
> Use:
>
> @since 8.4.5
> @since 8.3RC1
>
> This is supported by the javadoc, see 
> http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#author
>
> Also note that our Unstable annotation checker needs to be in sync (I’ve 
> opened http://jira.xwiki.org/browse/XCOMMONS-1071 in advance).
>
> The main rationale is that it’s more semantic to have one since per version 
> (similar to having one author par author).
>
> WDYT?
>
> Thanks
> -Vincent
>
> PS: I have already made changes for commons and waiting for agreement before 
> committing or discarding ;)
> _______________________________________________
> devs mailing list
> devs@xwiki.org
> http://lists.xwiki.org/mailman/listinfo/devs



-- 
Thomas Mortagne
_______________________________________________
devs mailing list
devs@xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs

Reply via email to