Shhhh, loud test.
Add some docs and specs and fix the transposed args that dialyzer found

NOTE: make dialyzer exits with an error, but no information. Could
do with some help on that.