added documentation to top of hierarchy