Документация класса

Помещайте в класс настолько много информации, насколько это возможно.

Задавайте заголовочные комментарии тщательно и согласованно; они являются частью официального интерфейса.