Consider using Roxygen2 for documentation

[mmulvahill]

via Roxygen2 vignette:

Roxygen2 provides a number of advantages over writing .Rd files by hand:

• Code and documentation are adjacent so when you modify your code, it’s easy to remember that you need to update the documentation.
• Roxygen2 dynamically inspects the objects that it’s documenting, so it can automatically add data that you’d otherwise have to write by hand.
• It abstracts over the differences in documenting S3 and S4 methods, generics and classes so you need to learn fewer details.

[mmulvahill]

Via conversation with @kechrisk low priority for now, but will reconsider this after first Bioconductor release

[mmulvahill]

Done