added comments/docs for all current methods