- updated documentation to be in sync with current code