question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Add a vignette to the R package

See original GitHub issue

Hello,

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:closed
  • Created 4 years ago
  • Comments:5 (2 by maintainers)

github_iconTop GitHub Comments

1reaction
kevinruecommented, Jul 31, 2019

With #43 I think that we can call this issue resolved.

0reactions
idrozcommented, Jul 31, 2019

Works great - merged #42 into master - thank you!

Read more comments on GitHub >

github_iconTop Results From Across the Web

R Packages (2e) - 18 Vignettes
Start adding prose and code chunks to the vignette. Use devtools::load_all() as needed and use your usual interactive workflow for developing the code...
Read more >
Writing vignettes - Karl Broman
To include an R Markdown document as a vignette in your R package, all you need to do is: Create a vignettes subdirectory....
Read more >
How to Add a Vignette to a Package in RStudio - R-bloggers
The easiest way to create a vignette in RStudio is using File | New File | R Markdown | From Template | Package...
Read more >
Package vignettes
Package vignettes. To enable Markdown vignettes in an R package, you need to. add *. · View vignettes. And R will load the...
Read more >
Create a vignette or article — use_vignette • usethis
General setup · Adds needed packages to DESCRIPTION . · Adds inst/doc to .gitignore so built vignettes aren't tracked. · Adds vignettes/*.html and...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found