:notebook: This book is currently under development and has been designed as a support for students who are following (or are interested in) courses that provide the basic knowledge to master "statistical programming" with R. Compiled textbook:
Hi everyone, I read the GitHub chapter and I think overall everything is pretty good and detailed! Thank you so much for all the hard work and sorry that I didn't help much in the process. After proofreading, I only have a few comments/questions and it would be great if you find them somehow helpful! Thanks a lot!
[x] “Introduction to GitHub” video may be added below 3.2 and before 3.2.1, which will seem more logical and reasonable I think.
[x] In the video “Introduction to GitHub”, Justin mentioned that the video about how to set up github is posted in piazza. I think the “Basic GitHub workflow” video has explained the set up part very well. So I would suggest that if that video is some necessary part, maybe not to post in piazza, post in textbook. Otherwise may be better not to mention “there’s another video in piazza” which seem that the info is a bit scattered.
[x] In the textbook, Git Bash is mentioned quite a few times. I don’t quite understand what is Git Bash? It is same as Git Desktop app? I think it’s better to stick on using Git Desktop if chosen, and explain how to do everything with Git Desktop. Because later it seems there are explanation on command for use in terminal (part 3.4), which sound a bit confusing to me… (Or maybe just because I’m slow and stupid)
[x] In section 3.3 before 3.3.1, “Here is a video demonstrating basic GitHub workflow within RStudio.” video missing but I think it’s on the way right?
[ ] I would suggest to add more explanation about the branching, such as: "what is master branch and other branches? what’s the difference of using different branches? if I create a branch how should I pull request or merge everything?" However, I think it may be better to recommend students to only use master branch for the class assignments for now. And if they are interested in branching, here is what they can do: then add a video to explain more about branch, pull request, push and merge etc.
[x] I think it’s better to remind students to remember to synchronize every time before they start to work, maybe added in the video or before “commits” 3.3.2 section
[ ] I think the “basic github workflow” is very detailed and explains a lot! Does it sound like a good idea to add some explanation about “readme” (since Justin mentions it in the video). Also explanation about “clone and download” maybe? Because in the video it’s taught how to set up a repo, but if one group member has created a repo others only need to clone it locally.. So I think it’s helpful to mention about this option on the website as well.
[ ] For the “understand what is going on” comic under 3.4, I think it’s better to be added in the beginning of this chapter? To remind them for everything below we need to understand what it means.
[ ] For slack part, I think it will be more helpful to explain a bit about how to create a channel (for group project) and how to integrate github into the channel, for their convenience of group project.
Hi everyone, I read the GitHub chapter and I think overall everything is pretty good and detailed! Thank you so much for all the hard work and sorry that I didn't help much in the process. After proofreading, I only have a few comments/questions and it would be great if you find them somehow helpful! Thanks a lot!
Git Bashis mentioned quite a few times. I don’t quite understand what isGit Bash? It is same asGit Desktopapp? I think it’s better to stick on usingGit Desktopif chosen, and explain how to do everything withGit Desktop. Because later it seems there are explanation on command for use in terminal (part 3.4), which sound a bit confusing to me… (Or maybe just because I’m slow and stupid)