documentation updates to pass tests and check