steady progress on the vignette
found some issues during the process <-- good!