added some docs to comments