enable a missing test
document all classes, functions, and methods and add doctests

improve some assertion messages