make the docs make a bit more sense