added notes to the methods