added some clarifying notes