r/javahelp • u/dr_avenger • 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?
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.
2
1
2
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
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
Apr 12 '19
[deleted]
1
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
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