shinier tests and better documentation