Some feedback on Search Results Page

David Alayachew davidalayachew at gmail.com
Mon Sep 1 17:35:42 UTC 2025


May also want a 4th column for module, but that's less important. Maybe
makes sense to put that behind a toggle.

And I want to emphasize, of these suggestions, the splitting up of
Description is the most important. That just makes my searching experience
more taxing, as the horizontal position of a package name is slightly
different for each line, making reading harder.

On Mon, Sep 1, 2025 at 1:24 PM David Alayachew <davidalayachew at gmail.com>
wrote:

> 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/538ff4cb/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/538ff4cb/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/538ff4cb/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/538ff4cb/image-0005.png>


More information about the javadoc-dev mailing list