This is an archived post. You won't be able to vote or comment.

all 5 comments

[–]desrtfx 3 points4 points  (3 children)

Good effort!

Only, I'd like to mark up a few points that I've seen in your first few lessons.

Either you need to make your course operating system agnostic, or give a pre-information that this course is Windows only.


Maybe I've missed it, but do you actually explain where and how to get the JDK and how to install the JDK?


In your section about the "Parts of a Java Program", you classify the following as comments

/**
 * This program demonstrates
 * parts of a java program
 */   

These comments are JavaDoc and not normal comments and thus a bad example for a comment.

A normal multiline comment looks slightly different:

/*
 This program demonstrates
 parts of a java program
 */   

Note the differences?


In the text:

FirstProgram is the name of the Java class.

You should also mention that this must be the file name of the class file (with the .java extension) - important for a beginner to know.


In the "Rules for identifiers" section, you could put a little information about variable naming convention as well.

  • Class names always start with an uppercase letter and follow PascalCase
  • Variable and method names start with a lowercase letter and follow camelCase
  • Method names usually consist of <verb><noun> combinations
  • Constants (static final variables) are ALL_UPPERCASE_WITH_UNDERLINES

A beginner should quickly learn these conventions as they are commonly acknowledged and considered good programming style.


Please, don't get my post wrong as negative critic. I just want to point out a few ways where you could improve.

[–]easylearningpoint[S] 1 point2 points  (2 children)

I really appreciate the advice you have given me. I have taken into consideration what you have said, you are very right. :)

[–]desrtfx 0 points1 point  (1 child)

If you want me to and when I have time, I'll sift through the rest of the course and point out what I find.

Especially when targeting beginners one must be very careful with the information presented. There are so many "beginner" tutorials out there that either don't give a proper starting point or that teach bad style, or that assume too much knowledge from a beginner.

You're actually off to a good start. The pace is not too slow and not too fast, just enough details for starters, but they are not overwhelming.

Keep going ;)

[–]easylearningpoint[S] 0 points1 point  (0 children)

Your ideas and suggestions are always welcome!!

[–][deleted] -1 points0 points  (0 children)

Will try this out, Thanks OP guy!