+1

Thanks,
Marius

On Tue, Sep 20, 2016 at 11: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
>
_______________________________________________
devs mailing list
devs@xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs

Reply via email to