Materials for workshop on research transparency, Remote 2020
UC Berkeley (Berkeley Initative for Transparency in the Social Sciences)
The workshop will introduce you to a tool that can help you make your workflow more reproducible: version control (Git/GitHub). You are required to install the following software programs either on your personal laptop before coming to the workshop for the hands-on exercises. (please remember to bring the laptop too!)
Version control is a powerful way to carefully track revisions to your documents as well as to manage collaboration. Git and Github Desktop are packaged together here. Git is the command line tool, and Github Desktop is a GUI version of the same tool.
Writing good code is facilitated by a good text editor. You can get away without one because you almost certainly already have a program on your computer that can save simple ASCII text files (Notepad for Windows, or TextEdit for Mac--but change the default from Rich Text to Plain Text) but modern text editors do syntax highlighting, auto-complete, and a bunch of other cool stuff for you. I suggest Atom. You can extend its functionality by going to settings and adding packages (one to render Markdown as PDF might be especially helpful.)
If you have downloaded R or RStudio, make sure that your version is up to date.
Open RStudio and click on the following File-> New File -> RMarkdown...
, when prompted to install additional packages, click yes.
If you could not install LaTeX previously, run the following 2 lines of code in the RStudio console:
install.packages(c("tinytex", "rmarkdown"))
tinytex::install_tinytex()
- Folder
01-git-gui
contains the slides for the git/github tutorial - Folder
02-dyndocs
contains the slides for the dynamic documents tutorial with R - File
handout.pdf
contains some short descriptions of the terminology used in git/github