update readme and api docs a bit