Add a vignette to the R package
See original GitHub issueHello,
For JOSS review.
Is your feature request related to a problem? Please describe.
The R package lacks documentation of an application to a real-life dataset.
Describe the solution you’d like
Please add a vignette in the R package demonstrating at least an example application to a single-cell dataset. Basically, the equivalent of the scanpy workflow here.
A convenient way to use the pbmc3k
dataset for demonstration purposes is the Bioconductor TENxPBMCData package.
Suggested code:
library(TENxPBMCData)
tenx_ pbmc3k <- TENxPBMCData(dataset = "pbmc3k")
Ideally, consider using the vignette (or a separate one) to also give an introduction to the functionality of the R package. It is not necessary to duplicate information already described in the documentation of the Python package (DRY principle); you may simply include a link to the main page.
Describe alternatives you’ve considered
A working example of an R workflow could also be included in the documentation of the Python package, although this is probably unnecessarily difficult to maintain. Ideally, that example would be run and tested for every new release of the Python and R source code.
Additional context Once you have an R vignette written, you should also consider using pkgdown to automatically create a GitHub website including the full package documentation.
Issue Analytics
- State:
- Created 4 years ago
- Comments:5 (2 by maintainers)
Top GitHub Comments
With #43 I think that we can call this issue resolved.
Works great - merged #42 into master - thank you!