roxygen documentation

Also improves captions and footnotes on markdown tables