looks fine Joe > On Mar 21, 2018, at 3:08 PM, Joe Wang <huizhe.w...@oracle.com> wrote: > > Hi, > > Please an accessibility fix for several package-info files. > > The report contained 4 items. Among them, 1 and 2 are issues in the javadoc > tool, and 3 could use an improvement in the tool or documentation. For > reference, please see the linked issues in JBS [1]. > > > For the current issue, we're fixing item 3 manually. Item 4 is a separate > issue, but it's bundled with this fix to cut the overhead. > > *Item 3*: Heading leavels should only increase by one > This is due to the javadoc tool generates a header with an addition of > headings, in this particular case, <h1>. The fix for this particular case is > to replace the <h3>s with <h2>. > > Since I know the java.xml packages suffer the same issue, I've included > them in this fix as well. For other modules, I'll leave it to the > accessibility team. > > The fix is verified using the accessibility tool, the issue "Heading > leavels should only increase by one" no longer showed for the new API doc. > > *Item 4*: Broken inner link > There were 4: 3 of them missed the "#" sign (as in "FEATURE", "INTERIM", > "UPDATE"), the last one was due to capitalization, the inner linked was > mistyped in lower case "#feature" when it should have been "#FEATURE". > > You may search the source with > > <a id=" > > to find the anchor, e.g. line 874 : > > <a id="FEATURE"> > > > > JBS: https://bugs.openjdk.java.net/browse/JDK-8199176 > webrev: http://cr.openjdk.java.net/~joehw/jdk11/8199176/webrev/ > > > [1] https://bugs.openjdk.java.net/browse/JDK-8199176 > > Thanks, > Joe >
<http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif>Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037 Oracle Java Engineering 1 Network Drive Burlington, MA 01803 lance.ander...@oracle.com <mailto:lance.ander...@oracle.com>
