add roxygen comments to more helper methods