SmogDr / edar_coursebook

1 stars 0 forks source link

R project & GitHub set-up / best practices #17

Closed wendtke closed 4 years ago

wendtke commented 4 years ago

@SmogDr, would you like students to submit homework via Canvas or GitHub? Brooke had us email her links to the GitHub files. Early in the semester, we emailed her Word documents (swirl instructions) or R Markdown files knitted to PDF.

Do you think the students will be set up in and using GitHub in time for the first homework submission?

wendtke commented 4 years ago

Add GitHub information in Chapter 1

Day Zero Happy Git

wendtke commented 4 years ago

Weeks 1-2

  1. Install R/RStudio; OS-specific installations like Xcode on Mac
  2. Create GitHub repo (private; add @SmogDr and @wendtke as collaborators) with these instructions. Optional lecture on git/GitHub background.
  3. Create MECH481A6.Rproj with this directory structure.
  4. Confirm git/GitHub connection to/from R project.

**a comprehensive R developer set-up, if students are interested in developing and sharing R packages eventually

wendtke commented 4 years ago

@SmogDr, would you like students to submit homework via Canvas or GitHub? Brooke had us email her links to the GitHub files. Early in the semester, we emailed her Word documents (swirl instructions) or R Markdown files knitted to PDF.

Do you think the students will be set up in and using GitHub in time for the first homework submission?

We want GitHub submissions but do all students have their own computers? @SmogDr to inquire

wendtke commented 4 years ago

The PR related to this issue will also address #14 (best practices for R project and git/GitHub) and #16 (private GitHub repository for each student).

wendtke commented 4 years ago

@SmogDr - do you want to create a GitHub organization with the students' private repos, or just have students host their own on their individual profiles? See here for more info.

wendtke commented 4 years ago

@SmogDr - see https://twitter.com/tiana_athriel/status/1292962508173533184?s=21

Do you envision going through installation together in class, or should I include screenshots in this PR?

SmogDr commented 4 years ago

I think we will do it in class but I would include the screenshots, too.

-- John Volckens Professor, Mechanical Engineering Colorado State University he, him, his jv.colostate.edu / @Smogdr

From: Kathleen Wendt notifications@github.com Reply-To: SmogDr/edar_coursebook reply@reply.github.com Date: Tuesday, August 11, 2020 at 11:21 AM To: SmogDr/edar_coursebook edar_coursebook@noreply.github.com Cc: "Volckens,John" John.Volckens@ColoState.EDU, Mention mention@noreply.github.com Subject: Re: [SmogDr/edar_coursebook] R project & GitHub set-up / best practices (#17)

@SmogDrhttps://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FSmogDr&data=02%7C01%7Cjohn.volckens%40colostate.edu%7Cd08a1af55ce04660258d08d83e1b0ae0%7Cafb58802ff7a4bb1ab21367ff2ecfc8b%7C0%7C0%7C637327633147275386&sdata=JFd5djjf%2FYY5GuM292lEZuAJVCUk%2B2mK%2FYt4O%2Bt7cBE%3D&reserved=0 - see https://twitter.com/tiana_athriel/status/1292962508173533184?s=21https://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftwitter.com%2Ftiana_athriel%2Fstatus%2F1292962508173533184%3Fs%3D21&data=02%7C01%7Cjohn.volckens%40colostate.edu%7Cd08a1af55ce04660258d08d83e1b0ae0%7Cafb58802ff7a4bb1ab21367ff2ecfc8b%7C0%7C0%7C637327633147285383&sdata=s1XtSa5gzR33BtkjficyNNQcSTgv1OjAax9K4ERXiLY%3D&reserved=0

Do you envision going through installation together in class, or should I include screenshots in this PR?

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHubhttps://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FSmogDr%2Fedar_coursebook%2Fissues%2F17%23issuecomment-672111403&data=02%7C01%7Cjohn.volckens%40colostate.edu%7Cd08a1af55ce04660258d08d83e1b0ae0%7Cafb58802ff7a4bb1ab21367ff2ecfc8b%7C0%7C0%7C637327633147285383&sdata=IP1DEUanuGKHwHuDp6%2BRV8Uhiz3XV81twT%2BBQQ0Kuic%3D&reserved=0, or unsubscribehttps://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FAOKS4TAC2V3FZ52FUKH4A43SAF43DANCNFSM4PJQ5JXA&data=02%7C01%7Cjohn.volckens%40colostate.edu%7Cd08a1af55ce04660258d08d83e1b0ae0%7Cafb58802ff7a4bb1ab21367ff2ecfc8b%7C0%7C0%7C637327633147295385&sdata=Pv4jH0tK6L9IHf93rWksHF7%2B53tdut0bLDDzhvs9l5s%3D&reserved=0.

wendtke commented 4 years ago

@SmogDr - do you want to create a GitHub organization with the students' private repos, or just have students host their own on their individual profiles? See here for more info.

@SmogDr - not sure if this GH ping got lost in the last day. What do you think of the above question?

SmogDr commented 4 years ago

I’m new to GitHub organizations but if we can do it with the each student’s repository being private then why not?

-- John Volckens Professor, Mechanical Engineering Colorado State University he, him, his jv.colostate.edu / @Smogdr

From: Kathleen Wendt notifications@github.com Reply-To: SmogDr/edar_coursebook reply@reply.github.com Date: Tuesday, August 11, 2020 at 2:48 PM To: SmogDr/edar_coursebook edar_coursebook@noreply.github.com Cc: "Volckens,John" John.Volckens@ColoState.EDU, Mention mention@noreply.github.com Subject: Re: [SmogDr/edar_coursebook] R project & GitHub set-up / best practices (#17)

@SmogDrhttps://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FSmogDr&data=02%7C01%7Cjohn.volckens%40colostate.edu%7C197a962c9b154dd3ecc108d83e37d7c7%7Cafb58802ff7a4bb1ab21367ff2ecfc8b%7C0%7C0%7C637327756850371254&sdata=MtB%2Fx1XYyQFaHADga870Pv1Te36kMazju5vRjgl4RFU%3D&reserved=0 - do you want to create a GitHub organizationhttps://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fhappygitwithr.com%2Fclassroom-overview.html&data=02%7C01%7Cjohn.volckens%40colostate.edu%7C197a962c9b154dd3ecc108d83e37d7c7%7Cafb58802ff7a4bb1ab21367ff2ecfc8b%7C0%7C0%7C637327756850376241&sdata=y1RIDFs1PQMSqa5%2Fhc8N0%2FyexcUKtLWjs6bOH3KpNqk%3D&reserved=0 with the students' private repos, or just have students host their own on their individual profiles? See herehttps://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdocs.github.com%2Fen%2Fgithub%2Fsetting-up-and-managing-organizations-and-teams%2Fcollaborating-with-groups-in-organizations&data=02%7C01%7Cjohn.volckens%40colostate.edu%7C197a962c9b154dd3ecc108d83e37d7c7%7Cafb58802ff7a4bb1ab21367ff2ecfc8b%7C0%7C0%7C637327756850381237&sdata=3eFxyRJA0%2B2SP187otppD1g%2FL4EN7sDXADd63RtqJnM%3D&reserved=0 for more info.

@SmogDrhttps://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FSmogDr&data=02%7C01%7Cjohn.volckens%40colostate.edu%7C197a962c9b154dd3ecc108d83e37d7c7%7Cafb58802ff7a4bb1ab21367ff2ecfc8b%7C0%7C0%7C637327756850381237&sdata=RLX1edjXbkxw30wSsMvusx8RZgDuZUZ9pGFf0ygubmw%3D&reserved=0 - not sure if this GH ping got lost in the last day. What do you think of the above question?

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHubhttps://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FSmogDr%2Fedar_coursebook%2Fissues%2F17%23issuecomment-672271061&data=02%7C01%7Cjohn.volckens%40colostate.edu%7C197a962c9b154dd3ecc108d83e37d7c7%7Cafb58802ff7a4bb1ab21367ff2ecfc8b%7C0%7C0%7C637327756850386225&sdata=x1kVQoPzDNhexY1iJ0M9IdezKpkfLJoiHOEp37l3ESk%3D&reserved=0, or unsubscribehttps://nam01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fnotifications%2Funsubscribe-auth%2FAOKS4TFZ3HKFPQD3WI3TLCLSAGVAHANCNFSM4PJQ5JXA&data=02%7C01%7Cjohn.volckens%40colostate.edu%7C197a962c9b154dd3ecc108d83e37d7c7%7Cafb58802ff7a4bb1ab21367ff2ecfc8b%7C0%7C0%7C637327756850391216&sdata=LfIjPowMnf6IXIWFreVIxNqJ3WWjn4NuhENzHWBTa5M%3D&reserved=0.

wendtke commented 4 years ago

Add Rtools/Rcpp to installation guidance, but RStudio offers to install Rtools automatically

https://thecoatlessprofessor.com/programming/cpp/installing-rtools-for-compiled-code-via-rcpp/ R version 4+ https://thecoatlessprofessor.com/programming/cpp/r-compiler-tools-for-rcpp-on-macos/

wendtke commented 4 years ago

Add usethis material (e.g., vaccination)

https://github.com/uncoast-unconf/uu-2019-day-zero/blob/master/00-preparation/03-usethis/README.md

wendtke commented 4 years ago

Add Rtools/Rcpp to installation guidance, but RStudio offers to install Rtools automatically

https://thecoatlessprofessor.com/programming/cpp/installing-rtools-for-compiled-code-via-rcpp/ R version 4+ https://thecoatlessprofessor.com/programming/cpp/r-compiler-tools-for-rcpp-on-macos/

From CRAN: "CRAN R 4.0.0 builds and higher no longer use any custom compilers and thus this directory is no longer relevant. We now use Apple Xcode 10.1 and GNU Fortran 8.2 from https://github.com/fxcoudert/gfortran-for-macOS/releases. For more details on compiling R, please see also https://mac.R-project.org/tools/"

wendtke commented 4 years ago

Closed by #22