docstrings. removed large out-of-date comment.
re-arranged asserts to be easier to read
bridge testing