revamp doco with roxygen