assertion fixes in tests, documentation update