extended tutorial + readme edits