documentation changes and a test fix