borked the docs and readme... [skip ci]