updates to functions and docs