Thou shall enter comments

Commenting is a standard practice when developing any application and it is no different when using APEX. Comments should be entered to help explain programming logic, business rules, development history, and any other useful information for developers. Almost every APEX component/object, definitely on the Page Definition page, includes a Comments field. That includes the page itself, items, computations, validations, processes, and almost any other APEX component.

On top of that, the APEX IDE supports a Developer Comments system, which allows us to document application-level issues and associate them with a relevant application page(s). The Developer Comments wizard is accessible through the Action Bar, using the balloon comment icon which is the second icon from the right. In the following screenshot we can see that the wizard tab allows us to define a developer comment. We can also see that other tabs of this wizard allow us to view and manage the existing...