added to package vignette (### Package Attributes section)