docs for users of this package