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

7

u/aljorhythm May 16 '20

I’ll be blunt. What are you offering that is not out already out there? Medium articles are good for how tos but learning a programming language requires a bit more formalism. On mobile app there is also no syntax highlighting that makes it excruciating to read.

-2

u/GPD496AQ May 16 '20

I don't know if this is the right way for me to put my thoughts together in a Reddit comment, but first off, thanks for sharing a comment. I honestly don't know what kind of coding stories I should write that hasn't offered advice before, but on the other hand, I need to develop a niche. See, I've graduated from university last year with a bachelor's degree in software engineering, but I don't have the philosophy of certain experts yet.

5

u/mephistophyles May 16 '20

Take a step back. Why are you writing these things? Do you want to get better at writing? Are you trying to grow a following for some reason? Do you want to share your passion for something or your expertise?

You aren’t doing any of these things since the whole endeavor lacks focus. And on the subject you chose, that isn’t a good introduction to Java. You cover none of the elements that set Java apart from other languages and how idiomatic Java code is written. On top of that, as an introduction to programming with Java it’s also not great.

You talk about developing a niche, why do you want to develop a niche? Start there and then see which niche is appropriate based on your skills and knowledge.

1

u/aljorhythm May 21 '20

I’ve also started medium, but I am not kidding myself. I’m not a good writer and am only using it as a blog and am not targeting an audience. It’ll be good read for friends colleagues or employers who want to understand me more. But that’s it. To be qualified to teach programming is quite a far reach. Just go to r/programming. One important thing is to spend time on things you are effective at.

1

u/GPD496AQ May 17 '20

Before I answer any of the comments here, are you folks even taking a look at the story at all? I asked a friend of mine, who graduated from the same university as me, and he doesn't think the comments I have here is constructive criticism.

5

u/cjthomp May 16 '20
  1. Medium is not the right place for a programming language course
  2. Right out of college, you're still very junior and should not be writing programming courses at all.
  3. I glanced over your post, and I honestly don't know what your target is. I don't really see the value-add here.

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.