added notes for each function