[infinispan-dev] JavaDocs and API documentation
Tristan Tarrant
ttarrant at redhat.com
Wed Feb 26 09:24:45 EST 2014
On 26/02/2014 15:02, Mircea Markus wrote:
> On Feb 26, 2014, at 1:05 PM, Tristan Tarrant <ttarrant at redhat.com> wrote:
>
>> Dear all,
>>
>> our JavaDocs currently encompass all of our classes, interfaces, etc
>> with no clear distinction between public and private API/SPI. I would
>> like to clearly mark which of our classes/interfaces are public API.
>> Should we:
>>
>> - add some decoration / visual cue to such elements to distinguish them
>> from the internal stuff
> I think Sanne mentioned and i think it was Hibernate that has impl sub-packages for all the non-public API.
> Sounds sensible to me, as people will see the impl in the class name when importing it, and that should raise question marks. shall we adopt that?
That would help, but we would still end up with a lot of noise in the
javadocs, for example the list of classes on the left has no separation
by package.
Tristan
More information about the infinispan-dev
mailing list