adding comments & func docs