Re: [xwiki-devs] [Proposal] Format for @since tags

On mar., sept. 20, 2016 at 10:24 AM, Vincent Massol <vincent(a)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(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/devs -- Denis Gervalle SOFTEC sa - CEO _______________________________________________ devs mailing list devs(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/devs