Javadoc Pages Use Full-Width of Screen

[adamhammes]

On my monitor the lines are 300 characters long, which I find to be close to unreadable.

I plan to submit a PR fixing this issue.

[dwtj]

Interesting. What's your plan?

Maybe this will get you pointed in the right direction. Currently, we don't really customize the styling of the Javadoc pages at all. We just use whatever the javadoc compiler outputs. Specifically, the :core:lang:javadoc Gradle task builds all Javadoc of the public API. This output HTML+CSS is placed in core/lang/build/docs/javadoc/. Then part of site's build process, specifically :site:javadoc, copies this over to the site's build directory, thus including it.

So, we aren't really controlling the styling of the Javadoc pages anywhere in this process, and the Javadoc pages don't use the rest of the site's styling at all.

Also, are you seeing the same styling as the standard library's javadoc pages, e.g. https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/FutureTask.html

[adamhammes]

I believe that the CSS can be set via a compiler flag to Gradle (http://stackoverflow.com/questions/39304791/edit-css-of-javadoc).

I actually can't remember what the standard library docs look like. Currently my only Internet access is my phone so the PR and the answer to that question are both stalled.