updated failing test, docs