On 18/04/2013 16:12, Mike Duigou wrote:
:
@implSpec is very welcome, more reasons now with the addition of default
methods.
Clearly distinguishing normative from non-normative text is also been a long standing
problem so having a tag to identify the non-normative text is very useful. I had to look
at a few examples in the lambda/jdk repo to convince myself that both @apiNote and
@implNote are needed. One thing that isn't clear to me is whether the
"official" Java SE documentation should include the text tagged @implNote or
not.
Once we got going we decided to fill out the matrix. There's no obligation to
use all of the tags.
Where @implSpec is used, then do you have a view on whether this should
be filtered out of the Java SE specs?
-Alan
