Presentation is loading. Please wait.

Presentation is loading. Please wait.

Commenting and Naming Conventions

Similar presentations

Presentation on theme: "Commenting and Naming Conventions"— Presentation transcript:

1 Commenting and Naming Conventions

2 Comment Your Code With small programs it may seem more trouble than it’s worth to add comments However, developing the good habit of commenting your code will save you much grief in the future as your programs get more complex – I speak from experience!

3 Here are a few suggestions as to why you should comment your code:
Finding errors and the flow of your program is more efficient. Software is often developed as a team where people work on only parts of a large program. Other team members should be able to understand what your part does and how it does it without having to ask you. You would want the same. If you change jobs, you may be responsible for a piece of software you created for your previous job. You don’t want your past to haunt you because the “new guy” doesn’t know how your code works It makes marking your code easier!

4 How to Comment in Java You can add comments in two ways:
Using two forward slashes will comment everything after them on that line only: Example: This is not commented // This will be commented This is not commented You can create a block of comment starting with /* and ending with */ /* This will be commented This is also commented This line is also commented */ JCreator indicates a comment by turning it this green color

5 What You Should Comment
You should comment any part of your code that you feel may need some clarification on What I will be looking for in terms of commenting are: The Header Section: Should include - This class, Name, Block, Project Name Methods: What the method does Variables and Constants: if name is not descriptive enough Classes: What the class does (we’ll talk more about classes in the future) COMMENT YOUR CODE!

6 Code Conventions Naming Conventions are part of Code conventions
These are guidelines to follow when coding in Java

7 Why Have Code Conventions
Why Have Code Conventions? (From Code Conventions for the JavaTM Programming Language Code conventions are important to programmers for a number of reasons: 80% of the lifetime cost of a piece of software goes to maintenance. Hardly any software is maintained for its whole life by the original author. Code conventions improve the readability of the software, allowing engineers to understand new code more quickly and thoroughly. If you ship your source code as a product, you need to make sure it is as well packaged and clean as any other product you create.

8 Use these conventions for naming in your program from now on
Naming Conventions You should be familiar with the conventions for the following Java elements Methods, Classes, Variables and Constants The information you need can be found at: Use these conventions for naming in your program from now on

Download ppt "Commenting and Naming Conventions"

Similar presentations

Ads by Google