Where is the potential confusion you try to avoid? And how does this change avoid it? Without any further clarification I would expect the same amount of descriptors no matter which of the two javadoc version I would get presented.