improve description of model class hierarchy and boundary conditions