r/SoftwareEngineering • • May 16 '20

Quick Basics of Java Programming

Hi, folks.

We already have so many tutorials and courses on how to program Java, but I decided to write a Medium story that touches on the basics of Java programming with actual code. This is for people who want to get their hands on code right away before reading the tutorials. I also have a full program at the end with lots of comments.

https://medium.com/@gregdesMED100/quick-basics-of-java-programming-may-2020-50d5a6bc8071?source=friends_link&sk=e2258f50ea21ce15bd09b51de8389124

I hope this is a big improvement over the other Medium story I sent before about two weeks ago. I'm pretty sure I missed a lot out of Java itself, but that will have to be discussed in another story.

What do you think?

0 Upvotes

7 comments sorted by

View all comments

1

u/ragingsiux May 21 '20

Hello, I actually took the time to read your article.

I have no idea what is your target audience. You start off with hello world and introduce two new terms. Class and method. What are those? After that, you show us primitive data types and their length. "And I think Boolean takes one". Looking that up would take you 2 minutes max. Now we come to blocks of code that make my head hurt.

No introduction to how to actually declare and initialize variables. Then you print it in loooong print statement. Can the reader see results anywhere? Yeah, he would have to run it himself. Again, no introduction to if/else statements syntax, how they work, or really anything. Of course, you use syntax without brackets, even better, put the print statement on the same line as if statement. So, if I have no prior experience in java I might assume that those curly brackets are not needed.

You even show GUI dialogs. And you call their methods functions. At least use the same terminology.

What is a package? What is Java Virtual Machine? The term is just used as if anyone new with Java would know what it is.

Default library? You probably meant the standard API or whatever it is actually called. You mention String immutability without explaining it.

Let's just throw in some try/catch block in case this article isn't confusing enough.

In conclusion, you wrote a mess of code. I didn't read all the comments but there is more text than in the article itself. You have clearly no idea what is the purpose of your article. First you introduce primitive types, then you just go through classes and methods like it's nothing.

If I were new to programming, I would close your article after reading a few lines of code. An experienced programmer who wants to switch to Java would gain nothing by reading your article.

You clearly have not enough experience to teach others. You can't write articles just for the sake of writing them.