improved the docs a bit