might be nice to make the docs a bit clearer about this