updates to usage fns and readme