Appropriate Comments and Comment Styles Include a summary at the beginning of the program to explain what the program does, its key features, its supporting data structures, and any unique techniques it uses. In a long program, you should also include comments to introduce each major step and to explain anything that is difficult to read. It is important to make your comments concise so that you do not crowd the program or make it difficult to read. These comments must precede just before the class or the method header and they can be extracted in a javadoc HTML file. Naming Conventions Make sure that the meanings of the descriptive names you choose for variables, constants, classes, and methods are straightforward.
Names are case-sensitive.
Listed below are the conventions for naming variables, methods, classes, and packages. For variables and methods, always use lowercase. Use singulars for variables representing single items such as student and count . Use plurals for arrays or collections. It is important to become familiar with the naming conventions.