RFR: JDK-8259806: Clean up terminology on the "All Classes" page

Hannes Wallnoefer hannes.wallnoefer at oracle.com
Mon Jun 7 13:40:33 UTC 2021


Yes, the move is from „All Classes“ to „All Classes and Interfaces“. 

This is also the new terminology used in the combined tabbed table in package pages, regardless of release.

Hannes


> Am 05.06.2021 um 21:16 schrieb Jonathan Gibbons <jonathan.gibbons at oracle.com>:
> 
> Up until recently, we used
> 
> Types (now Classes and Interfaces)
> Annotation Type (now Annotation Interface)
> Enum (now Enum Class)
> Record (now Record Class)
> 
> The general decision has been to use the older terms consistent with the usage throughout the documentation for the older releases.
> 
> I guess you have a corner case here, where you are fixing "Classes" (IIRC) and I guess it is "weird" to be retroactively changing it to deprecated terminology like "Types" even if it would be more consistent, especially when the new term is more accurate even for older releases.
> 
> -- Jon
> 
> On 6/4/21 11:57 PM, Hannes Wallnöfer wrote:
>> On Thu, 3 Jun 2021 17:09:21 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:
>> 
>>> Maybe I'm fighting a losing battle on this one, but the current policy is to generate the correct new terminology for recent releases and the older terminology for older releases, to try and stay consist within the release.
>>> 
>>> The mapping is handled semi-automatically in `HtmlDoclet.getResourceKeyMapper`, line 130. As a general rule, if you're changing terminology, you should at least be updating the mapping as well.
>> Is "Classes and Interfaces" part of the "new terminology"? I thought "classes and interfaces" would be the correct term for anything living in a .class file, regardless of release.
>> 
>> -------------
>> 
>> PR: https://git.openjdk.java.net/jdk/pull/4270



More information about the javadoc-dev mailing list