finalized comments & documentation