Some feedback on Search Results Page

David Alayachew davidalayachew at gmail.com
Mon Sep 1 17:24:32 UTC 2025


Hello @javadoc-dev at openjdk.org <javadoc-dev at openjdk.org>,

If I click "Search" on the top left of Java 24 Javadoc, and then when the
page loads, I type in "Subtask", it returns "StructuredTaskScope.Subtask"
with blue text. Here is a screenshot.

[image: image.png]

But if I do the same for Java 25 EA, not only is the columns different, but
the text color for the Class Name has changed from Blue to Black. Here is a
screenshot.


[image: image.png]

It is also the same for Java 26 EA. Here is a screenshot.

[image: image.png]

There's definitely some tradeoffs I can see.

For example, I can now see from a glance if it's an interface, a class, an
enum, etc.

But on the other hand, the "Description" column smushes 2 separate pieces
of data together -- class type and package. I would much prefer that these
be 2 separate columns, for a total of 3.

I also would like it if we could go back to having packages on the left, vs
the right. I understand that the class name is what people care about, but
since fully qualified names of classes start with packages, then I think it
also makes sense to have the packages be the first column. We can keep
class type (interface, enum, Exception, etc) as the 3rd column.

Finally, can we go back to the blue text? Blue is a nice signifier -- I see
blue, and I think hyperlinks. It kind of leads me into right-clicking to
open in a new tab, and since the blue pops out compared to the black, my
eyes naturally gravitate towards it, making it easier for me to find what I
need.

These are just a few suggestions from trying out the Java 25 Javadoc over a
period of time. I like it, but think it can be better.

Thank you for your time and help.
David Alayachew
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/javadoc-dev/attachments/20250901/0824b985/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 59219 bytes
Desc: not available
URL: <https://mail.openjdk.org/pipermail/javadoc-dev/attachments/20250901/0824b985/image-0003.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 57496 bytes
Desc: not available
URL: <https://mail.openjdk.org/pipermail/javadoc-dev/attachments/20250901/0824b985/image-0004.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 59911 bytes
Desc: not available
URL: <https://mail.openjdk.org/pipermail/javadoc-dev/attachments/20250901/0824b985/image-0005.png>


More information about the javadoc-dev mailing list