added some clarifying documentation