As you can see, even the Java class requires several lines
of codes and contains somewhat perplexing syntax. Large applications that
perform many tasks include much more code, and as you write larger applications
it becomes increasingly difficult to remember why you included steps or how you
intended to use particular variables. Documenting your program code helps you
remember why you wrote lines of codes the way you did. Program comments are
nonexecuting statements that you add to a program for the purpose of
documentation. Programmers use comments to leave notes for themselves and for
others who might read their programs in the future. At the very least, your
Java class files should include comments indicating the author, the date, and
the class name or function. The best practice dictates that you also include a
brief comment to describe the purpose of each method you came within a class.
