r/java • • Jul 08 '20

Java should get a website like developer.mozilla.org

It would be incredibly helpful for beginners and experts alike to have a single centralized Java/OpenJDK website. The website can have:

  • Links to download Java, or alternatively links to vendor pages.

  • Javadoc for every version of Java, that lets you easily toggle between versions

  • Tutorials & guides like https://docs.oracle.com/javase/tutorial/ and https://docs.oracle.com/javase/9/index.html

  • Link to submitting a bug report

  • JEP pages

  • Incorporate the OpenJDK wiki's content.

  • News / Blog section. Maybe also incorporate the new Inside Java blog.

  • Maybe some type of forum, but this is not required and may not be wanted anyway.

  • One or two non-intrusive ads to support the project's maintenance or the OpenJDK. Preferably simple image tags, no third-parties. There's lots of Java consulting, framework, and monitoring vendors who would be interested. For the love of god no Ask Toolbar please.

Mozilla's MDN is a great example of what could be. Because the website is opensource (or at least allows contributions), the tutorials and docs are always updated, unlike the Java Tutorials, which are still on version 8. And another benefit is that besides the community, Google and other large companies can contribute too. This eases the maintenance burden for Mozilla, just as it could for Oracle.

While I hate 'marketing' as much as the next guy, having a good looking, centralized website is really important nowadays and will make a much bigger difference than you think when it comes to beginner's interest. And so many of my fellow senior developers are 'cut off' from knowledge, because it's so scattered. Here on a JEP page, here on twitter, here on an old oracle blog. Java needs a 'home base.'

356 Upvotes

68 comments sorted by

89

u/[deleted] Jul 08 '20

Sure. The only problem is that its owned by oracle

12

u/DeontologicEthics Jul 08 '20

Microsoft is just as bad with their docs. Legal morass with domains and product 'ownership' happens at every big org. But I have faith that some of the smart OpenJDK contributors can push this through if they have the will & interest!

4

u/[deleted] Jul 09 '20

Yeah I disagree, C# and T-SQL documentation is like 10x better then Java and PL-SQL

I really love Java, but TBH my go to's for documentation are mostly spring.io and baeldung. The Oracle docs are not very good. PL SQL, man it's tough to get modern info, but that's outside of the scope of this but it just goes to show how bad Oracle is

11

u/jvallet Jul 08 '20

I don't know man, looks pretty good to me compared to this crap

1

u/xotonic Jul 08 '20

Haha, I see the crap for the 1st time. I guess it doesn't get indexed by Google engine

1

u/DrunkensteinsMonster Jul 10 '20

Hard disagree. The Microsoft docs for C# and Typescript are miles better than anything Oracle puts out.

0

u/[deleted] Jul 08 '20

[deleted]

12

u/GYN-k4H-Q3z-75B Jul 08 '20

I don't know man, C# and SQL Server reference docs are pretty good on TechNet.

Don't bother. Some people here just need to shit on C# and MSFT no matter what. docs.microsoft.com is messy but as far as documentation goes the stuff is pretty solid.

5

u/Lurkin_N_Twurkin Jul 09 '20

I agree. Coming from C# to Java, and I thought maybe I was just missing something about finding what I needed. Microsoft has pretty good C# docs. Good luck trying to figure out what MS office license is good for you or what version of windows server you need.

0

u/DeontologicEthics Jul 09 '20

I agree Java is unfortunately the worst out of just about all the major languages. But I also remember 5 years ago having to use Bing to search Microsoft's docs because google couldn't index it properly. And MS webdesign is still quite bad. Oracle needs to rehire whoever designed the Javadocs UI; the colors and dense layout work very well.

2

u/thephotoman Jul 10 '20

At this point, let us all concede that the vast majority of developers couldn't design a proper UI to save their lives. Hell, a lot of us would love it if we could get away with an X terminal (because we're old fogeys).

65

u/nile1056 Jul 08 '20

Luckily their website is grea....no wait, it looks like 90s garbage.

-4

u/NimChimspky Jul 08 '20

Adoptopenjdk is pretty good

111

u/beeeeeeefcake Jul 08 '20

Tutorials & guides

They should just buy baeldung.com and rebrand it. Props to the authors of those articles, they don't get paid very much and everything's superb quality. It's become about as useful to me as stack overflow.

43

u/Muximori Jul 08 '20

Agreed, baeldung is great.

13

u/Capitalpunishment0 Jul 09 '20

Woah. Never thought I'd see Baeldung mentioned here. Hard agree there. I'm only starting out with Java. I came from Python and there were a lot of great articles to read about it, but I couldn't find much with Java.

I had my doubts when I found Baeldung because I thought it looked "too simple." Boy was I wrong.

3

u/muztaba Jul 09 '20

I agree with you. Baeldung has lots of articles and you can use that for a quick start. But those are not in detail and not up to the mark.

7

u/geniosi Jul 09 '20

So much of this. It comes up in almost every search now, and I choose it over Stack Exchange any time! Explanations and examples are brilliant.

3

u/thephotoman Jul 10 '20

Except on those increasingly rare occasions where you get an article that's kinda stubbed and more note-like than a real explanation (either that, or their English skills were surprisingly weak for a developer--I've never met a developer who didn't have a high degree of fluency in English*). But even those had code examples with enough labeling that I could make out what was happening anyway.

* And the incomprehensible accents seem to be disappearing--or maybe I'm getting better at recognizing words through wildly differing accents. Today, the problems I have in understanding coworkers tend to be around either consistently talking too fast, speaking too quiet, or because of obvious speech impediments.

3

u/bakwods Jul 09 '20

Agreed. It is a great resource, props to the authors!

5

u/Serializedrequests Jul 09 '20

His articles are almost always too short to actually get you anywhere. They're always more like "this exists", but I inevitably have to look elsewhere to actually get up and running. He's good at getting Google hits and clearly knows his stuff, but as a spring newcomer I just want to block him.

I also find his lack of opinion irritating. Again as a newcomer a blog post on criteria queries could begin with "this API is terrible, check out QueryDSL", but nobody in Java seems willing to tell it like it is.

3

u/curiousSpectatorR Jul 09 '20

I agree with that, however baeldung is focused on Spring, not Java in general. Correct me if I am wrong though

6

u/doobiesteintortoise Jul 09 '20

Baeldung has general articles; they have a lot of Spring content, but they're hardly "focused on Spring."

2

u/curiousSpectatorR Jul 09 '20

I stand corrected :)

3

u/cryptos6 Jul 09 '20

But Bealdung is more about Spring, I think. However it is pretty good and very useful. I'm not sure whether this site would do well under Oracle.

1

u/thephotoman Jul 10 '20

I've had no problem finding JAX-RS and other JavaEE/Jakarta stuff on their site, either. They're the ones who gave me enough of an intro to JSR 299 that I could begin to understand it on my own.

I'd rather it be reorganized under joint Oracle (copyrights--there are good things in the official docs you might want to quote at length, trademarks)/OpenJDK (primary implementers of the language)/Eclipse Foundation (JavaEE/JakartaEE)/Apache Foundation (Apache Commons)/Spring Foundation (Spring) maintenance.

Holy crap, I just began to realize exactly how many hands are in the pot to give us a resource for the ecosystem at large. And that's not even talking about some of the more trailblazing frameworks and such.

Maybe Jetbrains? Because sure, why not, let's throw another hat in this ring.

1

u/pron98 Jul 12 '20

BTW, OpenJDK is Oracle's project (scroll all the way down), and while there are other companies and individuals contributing, 90% of the contributions come from Oracle.

20

u/iamanenglishmuffin Jul 09 '20

Also, developer.mozilla.org should be the top result in google when searching javascript docs, not w3 THAT SHIT SUCKS

7

u/muztaba Jul 08 '20

Check this out. https://inside.java/

2

u/jvjupiter Jul 09 '20

Compare that to https://www.python.org/.

1

u/muztaba Jul 09 '20

This is way good. But the inside.java is young age. Let's see how far it can get.

1

u/jvjupiter Jul 09 '20

java.net is more natural domain name for the Java language though.

16

u/cogman10 Jul 08 '20

Would be nice, but really, I don't see the necessity.

The javadocs are really pretty good. Certainly not as good as the MDN, but honestly better than what you'll find in a lot of places.

Particularly for difficult concepts, you'll often find a class or package level description with usage examples.

4

u/RufusThreepwood Jul 09 '20

I haven't used java much in a while, but when I was learning it 6~7 years ago, I thought the docs were actually really good. Far better than python for example. Almost as good as perl and MDN JS.

4

u/tiiv Jul 09 '20

Anyone remember the old java.net? That used to be THE goto-place.

1

u/jvjupiter Jul 09 '20

That should be enriched/enhanced - good looking site, responsive, full of contents, unified. Btw, OpenJDK is already under it - openjdk.java.net

4

u/MrJason005 Jul 09 '20

My 2 cents are:

Fix up the https://java.com website. It's been literally unchanged for ~15 years, and it feels like I time traveled back to 2007 and Java applets are still a thing. You got access to the domain. Redesign the website completely and make it as friendly as e.g. the rust website!

3

u/rossdrew Jul 09 '20

Java have been struggling with a useable download page for 10 years :P

4

u/[deleted] Jul 08 '20

Nothing will ever be as good as MDN. <3

2

u/jvjupiter Jul 09 '20 edited Jul 09 '20

I also have similar thought which I posted also here before. But it appeared many disagreed. Reading comments on your post, I also see some of them react negatively or are already fine with a number of sites for Java proliferating in the world wide web.

https://www.reddit.com/r/java/comments/ejltin/goodlooking_unified_website_for_java_programmimg/

1

u/GrayDonkey Jul 09 '20

I think https://developer.oracle.com/java/ is probably the closest to what you're looking for.

1

u/jvjupiter Jul 12 '20

It should be moved to java.net then.

1

u/neck_crow Jul 09 '20

Building in mvnrepository would be awesome too

-5

u/seraphsRevenge Jul 08 '20

make one

0

u/[deleted] Jul 08 '20

[deleted]

3

u/TomahawkChopped Jul 09 '20

The Java SE API is just going to be the "official" docs Oracle publishes as part of the Oracle JDK, but the documentation itself is almost entirely from the OpenJDK source code. e.g here is Collection.java

https://github.com/openjdk/jdk/blob/master/src/java.base/share/classes/java/util/Collection.java

This is all distributed under GPLv2. You're absolutely free to distribute this as long as you link to/provide the source

2

u/seraphsRevenge Jul 09 '20

What does making a collective site with links have to do with copying documentation.

-3

u/FilsdeJESUS Jul 08 '20

https://www.journaldev.com/ A great website for java lovers

-3

u/[deleted] Jul 08 '20

JEPs are available online... I don't see the need for a page when alk you mention is already available.

0

u/[deleted] Jul 08 '20

[deleted]

3

u/thephotoman Jul 10 '20

The difference is the founder.

Bill Gates is an engineer with a decent knowledge of how to do business. He had written a BASIC interpreter for the 8088 that he was quite proud of and shopped it around.

Larry Page and Sergei Brinn were a couple of engineers who were facing an internet that was growing exponentially and thus couldn't be indexed in a traditional manner. So they wrote a program to solve this problem and also make themselves rich (because they knew that "what are people searching for" was valuable data).

Larry Ellison is a manager. He wasn't a teenage or college era hobbyist. He was a guy who got a job running an engineering project (not doing the engineering).

1

u/pron98 Jul 12 '20

Ellison actually was a programmer before he was a manager, at least in college, although reports differ about his programming skills.

1

u/thephotoman Jul 12 '20

The key is that Ellison had been a manager before founding Oracle.

That wasn't true for Gates or Jobs, who began their companies in a basement and a garage, respectively, and largely from their own work. In fact, Jobs got run out of Apple because they felt they needed an older, more experienced manager to run the company. Gates never got the same treatment largely because he was also educated on the ways of being an entrepreneur.

97

u/[deleted] Jul 08 '20

[removed] — view removed comment

8

u/tart-e-flan Jul 09 '20

That Inside.java looks nice, is there a way to subscribe by email?

5

u/pjmlp Jul 09 '20

1

u/[deleted] Jul 09 '20

The RSS link should be available directly from the homepage.

3

u/pjmlp Jul 09 '20

And it is, where do you think I took it from?

1

u/[deleted] Jul 09 '20

There is nothing visible on the home page that says "Subscribe RSS" or something similar (or maybe Firefox doesn't display it).

I can see only the "View by links" at the top and three links in the footer named "About This Site | OpenJDK Community | Download Java" nothing about a RSS feed.

How should anyone visiting the site know that the RSS link is feed.xml?

4

u/pjmlp Jul 09 '20

There is the RSS logo at the bottom of the page alongside Facebook, Github and YouTube, quite easy for anyone that has ever used RSS.

1

u/[deleted] Jul 09 '20

10

u/GramaryeEUW Jul 09 '20

Turn off your Adblocker. Some block these Social-Buttons, including RSS

5

u/jvjupiter Jul 09 '20

We should leverage on java.net domain. There are already active subdomains under java.net, one is openjdk.java.net. This domain would be the best main page for Java. We should enrich that site for Java.

0

u/[deleted] Jul 09 '20

[deleted]

3

u/amackenz2048 Jul 09 '20

What I always like is a website requiring a user account to download something that is free.

Oh - and maybe we should go back to using a custom downloader! That was awesome.

2

u/pron98 Jul 12 '20 edited Jul 12 '20

If you're referring to the Oracle JDK, then it's only free for evaluation and development, and doesn't require an account for the current version, just old ones. It is intended for Oracle support customers. Oracle publishes the JDK for non-customers on jdk.java.net, and no user account is required for those.