Add tutorial "Building a Java application in IntelliJ IDEA" (fixes #62)

[mlvandijk]

Add tutorial for "Building a Java application in IntelliJ IDEA", based on the outline as discussed in #62 with the following additions/changes:

• "Searching and navigating" (another upside of using an IDE, imho)
• Version control (which I'm also fine to remove again, if it's not considered beginner friendly enough. I'd already written it so thought I'd include for now)
• Testing and debugging -> Split into 2 sections, as a. it got too long, and b. its also possible to run the application in debug mode.

Please let me know what you think / if any changes are needed.
Thanks!

[oracle-contributor-agreement]

Thank you for your pull request and welcome to our community! To contribute, please sign the Oracle Contributor Agreement (OCA).
The following contributors of this PR have not signed the OCA:

• PR author: mlvandijk
• mlvandijk@gmail.com (@mlvandijk)

To sign the OCA, please create an Oracle account and sign the OCA in Oracle's Contributor Agreement Application.

When signing the OCA, please provide your GitHub username. After signing the OCA and getting an OCA approval from Oracle, this PR will be automatically updated.

If you are an Oracle employee, please make sure that you are a member of the main Oracle GitHub organization, and your membership in this organization is public.

[danthe1st]

I am just providing my opinions here.
At the end, it's Oracle's Devrel team deciding what to include here (amd how that should be written).

Especially the beginning feels a lot like an advertisment as opposed to an article I would expect on dev.java.

Also, I think that quite a few things are fairly irrelevant to beginners.

This article contains quite a few images which is a strong contrast to many other articles. I don't know how well that fits in.

[danthe1st]

Also I think you haven't added your name as an author. I don't think this is mandatory but I wanted to make sure you know about it being possible.

[mlvandijk]

@danthe1st Thanks for taking the time to review, I really appreciate it! Please note that I took an existing article on coding with an IDE and used that as an example for the description and the content. An outline of the content was discussed in the proposal (#62). I'll address a few of your comments separately, but ultimately wait for review from Oracle DevRel team on what to change.
For example, I did notice the option to add my name as an author, but tbh I care more about adding the content then I do about having my name on there. Happy to add it if required.

[ammbra]

Hi Marit,

I left a few comments on the draft.

[mlvandijk]

@danthe1st @ammbra Pushed changes that resolve most but not yet all of the comments. Remaining few I'll think about and make more changes later.

[mlvandijk]

Also, OCA is in progress.

[danthe1st]

These are just minor nitpicks.

[mlvandijk]

@ammbra As discussed: Add myself as author

[ammbra]

Please check my comments.

[mlvandijk]

Hi @ammbra - pushed changes that should resolve all remaining comments in line with what we discussed last week. OCA stil in progress on our end.

[danthe1st]

I don't really see #70 (comment) being addressed.
Also I don't see anything coming out of #70 (comment) (most of the Evolving the project is pointless for beginners in my opinion and I don't see any summary).
I still don't agree with it being necessary to make Maven a fundamental part of this tutorial just for the sake of being able to introduce testing but if it is that way, it's fine.
One other thing I noticed is that you wrote macOS a few times with a lowercase m. Is it actually called macOS instead of MacOS?
Aside from that, it might be a good idea to group all IDE articles together similar to how the Classes and Objects section is grouped (to not occlude the /learn page too much) but I will await Ana's decision on that.

[ammbra]

I don't really see #70 (comment) being addressed. Also I don't see anything coming out of #70 (comment) (most of the Evolving the project is pointless for beginners in my opinion and I don't see any summary). I still don't agree with it being necessary to make Maven a fundamental part of this tutorial just for the sake of being able to introduce testing but if it is that way, it's fine. One other thing I noticed is that you wrote macOS a few times with a lowercase m. Is it actually called macOS instead of MacOS? Aside from that, it might be a good idea to group all IDE articles together similar to how the Classes and Objects section is grouped (to not occlude the /learn page too much) but I will await Ana's decision on that.

I will wait for @mlvandijk to push some more changes and once this is done, will look into fitting this article in they are own section/series.

[mlvandijk]

@ammbra - Just pushed the changes as discussed today.
@danthe1st - Nice catch on JUnit 5 -> fixed this as well. And yes, it is macOS (see the apple website).

[danthe1st]

I ran the article using the tooling locally, read through it and found a few things, see my comments.

Also, I don't know how I feel about the many links (except the documentation section, each section links to a jetbrains.com site at least once) in the article but I think it might be fine.

Finally, I still think the introduction feels a bit too much like an advertisment.

[mlvandijk]

@ammbra @danthe1st - do either of you want to raise issues for some topics that were mentions as "should have it's own section" during the review? Off the top of my head, this was mentioned for: version control/git, build systems (Maven/Gradle), testing. Once those are available we can link to them from this article / other relevant places.

[danthe1st]

I am unsure on whether these should actually be articles as these things are not really a part of Java (especially version control/git).

[oracle-contributor-agreement]

Thank you for signing the OCA.

[ammbra]

Hi Marit,

Thank you very much for your patience and for your effort on continously enhancing this article. I left a few comments on what can be further improved. I also resolved some of the conversations.
Once again, thank you and I hope that next version would be the perfect and the last one.

[mlvandijk]

Hi @ammbra - I've updated as per your suggestions and did a final review myself, where I made a few small fixes (I've added comments on what & where in this review).

[ammbra]

Looks good to me.

[carimura]

This is great, thank you again @mlvandijk for getting this over the line, @danthe1st for the reviews, and @ammbra for sponsoring. I've reviewed and all looks good! Let's get this PR merged and then I'll get it merged to prod.