Updated internal docs and vignette