add clarifying comments