UMCarpentries / intro-curriculum-r

Custom curriculum for teaching R, the Unix Shell, & Git with an integrated workflow and reproducible research practices.
https://umcarpentries.org/intro-curriculum-r/
Other
9 stars 12 forks source link

Write paper to submit to JOSE #138

Closed kelly-sovacool closed 3 years ago

kelly-sovacool commented 3 years ago
MrFlick commented 3 years ago

Very nice paper. I added a few small comments. Maybe it might be good to mention that this curriculum uses a "tidyverse" first approach rather than focusing on base R. For many of the reasons listed here: http://varianceexplained.org/r/teach-tidyverse/

zenalapp commented 3 years ago

Just updated Fig 2

dkcoxie commented 3 years ago

Paper looks great, thanks to all and excited to see this published.

pschloss commented 3 years ago

Agreed - I’d stick with comprehensive.

On May 19, 2021, at 11:37, Zena Lapp @.***> wrote:

@zenalapp commented on this pull request.

In paper/paper.md https://github.com/UMCarpentries/intro-curriculum-r/pull/138#discussion_r635361505:

  • index: 5
    • name: Independent educator
  • index: 6
    • name: Biological Station, University of Michigan
  • index: 7 +date: 27 Apr. 2021 +bibliography: paper.bib +---
  • +# Summary

  • +Inspired by well-established material and pedagogy provided by The Carpentries @._software_2016], we developed a two-day workshop curriculum that teaches +introductory R programming for managing, analyzing, plotting and reporting data using the R tidyverse @._welcome_2019], the Unix shell, version control with git, and GitHub. +While the official Software Carpentry curriculum is well-thought-out and comprehensive, we found Not sure I like "well-thought-out". Maybe delete?

⬇️ Suggested change -While the official Software Carpentry curriculum is well-thought-out and comprehensive, we found +While the official Software Carpentry curriculum is comprehensive, we found — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/UMCarpentries/intro-curriculum-r/pull/138#pullrequestreview-663369308, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAJUUBAINXPOLZNQCXRJRWLTOPLNDANCNFSM434TCBJQ.

pschloss commented 3 years ago

I agree that there are too many R’s :) Also “R tidyverse” doesn’t work for me - Perhaps…

introductory R programming for managing, analyzing, plotting and reporting data using the packages from the tidyverse

On May 19, 2021, at 11:35, Zena Lapp @.***> wrote:

@zenalapp commented on this pull request.

In paper/paper.md https://github.com/UMCarpentries/intro-curriculum-r/pull/138#discussion_r635358965:

  • index: 4
    • name: Center for Political Studies, Institute for Social Research, University of Michigan
  • index: 5
    • name: Independent educator
  • index: 6
    • name: Biological Station, University of Michigan
  • index: 7 +date: 27 Apr. 2021 +bibliography: paper.bib +---
  • +# Summary

  • +Inspired by well-established material and pedagogy provided by The Carpentries @.***_software_2016], we developed a two-day workshop curriculum that teaches +introductory R programming for managing, analyzing, plotting and reporting data using the R tidyverse Is it weird to say "introductory R programming....using the R tidyverse"? Maybe we should instead say:

⬇️ Suggested change -introductory R programming for managing, analyzing, plotting and reporting data using the R tidyverse +introductory programming for managing, analyzing, plotting and reporting data using the R tidyverse or

⬇️ Suggested change -introductory R programming for managing, analyzing, plotting and reporting data using the R tidyverse +introductory R programming for managing, analyzing, plotting and reporting data using the tidyverse Don't have a super strong opinion about this, but it sounds just a bit clunky to me right now.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/UMCarpentries/intro-curriculum-r/pull/138#pullrequestreview-663366097, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAJUUBG4M77FCCGMY5CWG2DTOPLCTANCNFSM434TCBJQ.

pschloss commented 3 years ago

Effectively or efficiently?

On May 19, 2021, at 11:28, Zena Lapp @.***> wrote:

@zenalapp commented on this pull request.

In paper/paper.md https://github.com/UMCarpentries/intro-curriculum-r/pull/138#discussion_r635352602:

+1. Perform version control using the Unix shell and git. +1. Create reproducible reports using R markdown. +1. Share code with others on GitHub. + +We believe these skills provide a solid foundation from which learners can teach +themselves any additional coding skills that they will need in the future. + +## Course Content + +Our curriculum consists of modules that cover setup, data analysis and +visualization, version control, sharing code, and writing reports. +We also provide a goal for the workshop: to create a fictitious report for the +United Nations on the relationship between gross domestic product (GDP), life +expectancy, and CO~2~ emissions. +The R programming lessons take a "tidyverse first" approach @._teach_2017] so learners can meet this goal. ⬇️ Suggested change @._teach_2017] so learners can meet this goal. @.***_teach_2017] to quickly teach learners powerful tools for plotting and data analysis. @kelly-sovacool https://github.com/kelly-sovacool @sklucas https://github.com/sklucas here's one possibility. not sure 'quickly' is quite the right word, but can't think of anything better right now

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/UMCarpentries/intro-curriculum-r/pull/138#discussion_r635352602, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAJUUBFQRGOIRPZ7D3RHWVLTOPKILANCNFSM434TCBJQ.