Previous chapters include a number of examples of classes (or partial classes) from the themed application,
the main purpose of which is to illustrate programming concepts. It should not have escaped the notice of
the reader that these examples often include material other than Java statements, usually in a non-bold font.
The inclusion of such material raises a question: what is the purpose of documentation is a class definition.Chapter One takes examples from the Java Application Programming Interface (API) and the themed
application in order to emphasise the critical importance of documentation. The examples are used to
show how documentation is organised in the API and how it is inserted into developer’s code.