JDK-8248869 : Consider using definition lists instead of tables for summaries.
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 15
  • Priority: P4
  • Status: Closed
  • Resolution: Duplicate
  • Submitted: 2020-07-06
  • Updated: 2021-04-12
  • Resolved: 2021-04-12
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
tbdResolved
Related Reports
Duplicate :  
Relates :  
Description
Tables don't work well for small devices.

Pretty much all of our tables are composed of rows of the form 
    <item> <description> 
even if the item is sometimes itself a pair forming a signature, such as <type> <name>.   

All these tables could reasonably be replaced by HTML <dl> lists, with the <dt>for the item and the <dd> for the description. And, we can use CSS and inline blocks to layout these as tables on big screens and go to a different more flow-oriented verical layout on small devices.

There is one notable exception I can think of for tables, and that is the package table for a module declaration when the command line options are set to show all details, including details of qualified exports and qualified opens. (We do not do this for JDK docs). For this table, there may be additional columns for the target of the qualified export or opens.  For these directives, one possibility would be to reorg the presentation to use a "notes" section to list the targets ... i.e. 
  Exported To: <list> and/or 
  Opened To: <list> 
similar to the Returns and Parameters for a method declaration.
Comments
Tables were replaced in JDK-8253117, although not with definition lists as suggested here but with divs using a CSS grid layout.
12-04-2021