improved docs
0.3.1 adjusts params documentation to their actual order