nit: docstring please? can be really brief. maybe include a link to the wiki page.