explanatory comments on custom classes