next gen javadoc

Jonathan Gibbons jonathan.gibbons at oracle.com
Wed Oct 14 22:16:32 UTC 2015


Sean,

It's always fun to see people experimenting with ways to improve javadoc 
output,
but in this case, there's something even more fun coming up, which will 
make your
improvements somewhat unnecessary.

I'm referring to "javadoc search", JEP 225, http://openjdk.java.net/jeps/225

Although it is specifically listed as a Non-Goal of JEP 225 to change 
the current
frames layout, it may be the case that we will change the default to 
show "no frames"
instead of "frames".  In other words, the default view will be to show 
the "main" frame,
including a search box, and to navigate to any type, constructor, method 
or field
you'll be able to just enter some or all of the name and signature if 
appropriate.
JEP 225 hints that we may eventually want to drop the "frames" view 
altogether.

With respect to your experiment, I would note that it is an important 
use case
for javadoc documentation to be served and displayed locally, without any
interaction with any server other than the local file system.

-- Jon

On 08/20/2015 09:22 PM, Sean Hogan wrote:
> I've revisited replacing <frameset>s with a AJAX + history.pushState
> framework and thought I'd play around with the javadoc UI again.
>
> You can see a current working prototype at:
>
> http://playground.meekostuff.net/javadoc/jdk9/docs/api/overview-summary.html
>
> Same notes and caveats as last time:
>
> - this is a proof-of-concept
>
> - navigating a hyperlink or via back and forwards buttons updates the
> address-bar URL
>
> - the original javadoc output HTML is completely unchanged.
>
> - the UI is in one separate HTML document...
>
> - so updating the UI is simple and independent of javadoc generation
>
> - there is only this one modified javadoc set on the site. If you view
> this set and follow a hyperlink to an external page then you will
> receive an error page
>
> - there is also a javascript bookmarklet that can apply the UI to
> javadoc7,8,9 generated sites.
>
> Feedback is welcome.
>
> regards,
> Sean



More information about the javadoc-dev mailing list