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

Reply via email to