Page MenuHomePhabricator

Readme improvements
Open, HighPublic

Description

In this task the open suggestions for improvement of the readme file to get started with "challengeR" toolkit will be described.

  1. There are two readme-s, it is confusing witch one should be used.
  1. For some sections (Load data, perform ranking, perform bootstraping) may be helpful to provide customize scripts with different options.
  1. Troubleshooting section?

As it is not required to used certain software (R studio, MikText), but there are some issues appearing when using specific software, we would suggest to add a troubleshooting section to clarify such issues, e.g.:

  • Specific Rstudio (e.g.: installation section)

    -> devtools::install_github("wiesenfa/challengeR", dependencies = TRUE) output: WARNING: Rtools is required to build R packages, but is not currently installed. Rtools was installed via a separate executable: https://cran.r-project.org/bin/windows/Rtools/

    -> installation of other packets (e.g.: glue)
  • MikText: issue generating the report

Event Timeline

aguilera added a subscriber: wiesenfa.
aguilera updated the task description. (Show Details)Mar 20 2020, 9:15 AM

There should be a team section where all of you are acknowledged

After discussing, the next steps have been decided:

  1. @wiesenfa: look into a way to output a the readme.md in another way (probably in another folder)
  2. @aguilera: create scripts to extend the code from the readme, in a different folder
  3. @aguilera: crete a troubleshooting section
eisenman triaged this task as High priority.Tue, May 12, 10:48 PM