readme: fixes and expanded usage example