revise readme and intro vignette