Documentation a tweaked API to make the parameters clearer