r/javahelp • • Apr 12 '19

Why do the official oracle java docs look like its been from the beginning of the web?

I could create a chrome/firefox extension so that it makes the site a bit easier to read, Will anyone will use it?

I have studied java in my college days, Now I feel like I should to get back to java and try some experiments. There are countless java tutorials and I am pretty happy with those. But I went to the official java docs site https://docs.oracle.com/javase/tutorial/java/index.html, and I feel like I went back 50 years. compared to MDN, python.org, or php.net I feel very sad towards the site.

Maybe it's because of the high res display I use, I find it very hard to read because of the looong horizontal lines, and poor font choices. and it's really unresponsive, Any reason they have kept it that way?

26 Upvotes

13 comments sorted by

11

u/desrtfx Out of Coffee error - System halted Apr 12 '19

What you have linked is not the documentation, it's the tutorial.

The documentation is something entirely different: https://docs.oracle.com/javase/8/docs/api/overview-summary.html

0

u/dr_avenger Apr 12 '19

Yes, I noticed and tried to change the title, but the harm is done. I can't change the title, but I hope the description addresses the issue :(,

8

u/wildjokers Apr 12 '19

I don't see anything wrong with it. If you don't want long lines just shrink your browser, it is responsive. I personally like sites that use most of the horizontal width. I absolutely hate when a site makes me read something in a small column, then has huge areas of unused space to the left and right. Ridiculous.

The tutorial site is perfect the way it is and doesn't require any changes.

https://motherfuckingwebsite.com

2

u/dr_avenger Apr 12 '19

That shit fuckin works

1

u/amackenz2048 Apr 13 '19

IE7? That page needs to update its references ..

2

u/[deleted] Apr 13 '19

i would use the absolute FUCK out of a chrome extension like that. Oracles Java doc makes me want to have a stroke every time i go to the site.

Please, for the love of God, make the extension.

Edit: Yes the Java site is manageable, however it is still tedious and poorly designed in my opinion. Plz save us, you’re our only hope

2

u/dr_avenger Apr 13 '19

Thank you. Finally you made move ahead with the decision. I will try my best. I will update here soon

1

u/wildjokers Apr 13 '19

Designed poorly? What do you mean? It has information on a page, what more do you need?

1

u/[deleted] Apr 13 '19

Again, I recognize it functions well, but IMO it’s poorly designed. Interface is subpar, inheritances and class references aren’t always clear, overall I dread having to go to the website for information.

Especially when compared to pythons site, there is improvement to be made is all.

6

u/sebnukem Apr 12 '19

Shorten the long lines by resizing your browser on your hi-res display. Personally I like plain old documentation over shiny and distracting and empty doc.

2

u/hugthemachines Apr 12 '19

I mean the parts of their site where you download java or jdk are pretty bad so I am not surprised.

2

u/codytheking I teach Java Apr 12 '19

I agree it looks a little outdated, but I have never found that it is hard to read.

0

u/[deleted] Apr 12 '19

[deleted]

1

u/[deleted] Apr 12 '19

True... I'm always hoping one day to wake up in the morning and read in the news "IBM buys Oracle"... a man can dream I guess