UPDATES TO THE README AND VIGNETTE

final updates to these files before creating the first release on GitHub