small progress on ml vignette and more refs in bib