add documentation notes, remove commented code