grosling icon indicating copy to clipboard operation
grosling copied to clipboard

Roxygen2 documentation

Open evanbiederstedt opened this issue 2 years ago • 1 comments

Hi @manzt

This is my normal spiel below:

It would be nice to get this on CRAN when the code is ready. The big impediment to this is always the roxygen2 documentation.

--- if a function is not exported, please use the tag #' @keywords internal. It's useful to know which functions are exported and which are not --- if a function is exported, please document all fields. Please use the format #' @parameterName type Explanation here (default=xxx). It's very useful to know the data type in the rxoygen2 comments. --- it will be useful for CRAN reviews if all exported functions have examples, but....that doesn't always happen. But let's try our best.

With this, the other steps will be much easier, and we can quickly get this on CRAN.

Once you're ready to publish the package, let me know. I'll help clean things up.

See related discussions e.g. here: https://github.com/kharchenkolab/numbat/issues/1

Thanks, Evan

evanbiederstedt avatar Jul 22 '22 17:07 evanbiederstedt

Super useful. Thank you!! I'll ping you when I've cleaned things up.

manzt avatar Jul 22 '22 17:07 manzt