adding tests from docs; updating docs