add a header comment giving an overview of objects in this file

This captures the discussion in #63.