add clarifications to some instructions