+1 2016-09-20 10:42 GMT+02:00 Denis Gervalle <d...@softec.lu>:
> On mar., sept. 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? > +1, but do we list them ascending, descending, any order ? > > 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 > -- > Denis Gervalle > SOFTEC sa - CEO > _______________________________________________ > devs mailing list > devs@xwiki.org > http://lists.xwiki.org/mailman/listinfo/devs > -- Guillaume Delhumeau (guillaume.delhum...@xwiki.com) Research & Development Engineer at XWiki SAS Committer on the XWiki.org project _______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs
