more documentation, rebuilt vignette