improved usage docs
further docs tweaks