more tests and document the state of things