Add some clarifications to code