Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New Core C/D Assessment Project Template #1

Open
14 tasks
gvegayon opened this issue Feb 27, 2018 · 0 comments
Open
14 tasks

New Core C/D Assessment Project Template #1

gvegayon opened this issue Feb 27, 2018 · 0 comments

Comments

@gvegayon
Copy link
Member

This document provides a general framework for assessing the software and computing needs of a particular project.

The first step consists on answering the following questions:

  • In a paragraph, describe what is the project about.
  • List the project's specific goals (e.g. make the method available for public use, create a webservice, present this analysis)
  • Think about what are your computing/software needs, and list them.

Once a general overview of the project has been defined, the next step consists on analyzing the following:

R packages development

Fundamental questions/tasks

  • Check for other R packages/software that does what the project tries to do.
  • Describe the ultimate goal of your R package (e.g. solve an optim problem, implement a visualization problem, estimate parameters, etc.)
  • Think about data (if any needed), in particular, input/output, have you checked any R packages that already have this?
  • Create a repository for the package.

Once the project is on git, following checkmarks

  • The package uses roxygen2 (you can turn your package Rd files to roxygen using Rd2roxygen).
  • The package's functions are throughly documented. This includes: Description, parameters (@param), value (@return), details (if any), examples (@details), references (@references) and links to other functions (@seealso, and @family).
  • The package has been fully tested using testthat or other framework.
  • The project is built using Continuous Integration services as Travis-ci and Appveyor (use the usethis package to set it up, eg: usethis::use_travis).
  • The package includes a vignette with an extended example and, if needed, references on the package.
  • The package has a website (suggest using pkgdown)
  • The package has been uploaded to CRAN or BioC.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant