Learning to use Github for documentation, collaboration, revision and version control
This repository is designed to teach the use of github for collaboration, communication, and documentation. This class is a combination of a classroom and an asynchronous exercise.
If at any point you need help please reach out to one of the mentors listed here. If you'd like to volunteer as mentor add you name to the list.
- Install Visual Studio Code here
- If you are just getting started with Github install Github Desktop instructions here
- If you are comfortable with typing into a terminal and/or would like to maintain continuity with the DataCamp class you can use a terminal. Instructions for getting setup with the "typing" version of Github are here
- If you have not already done so in the earlier steps sign up for a free Github account here here.
- Once you have and account and are actively using Github we can add you to the ODA Organization on Github. Our public projects are here
- Send Seth your github name and he will give you permission to write to the repository.
- Explore to get a sense of what of what Github and how its used. I found a few interesting repositiories:
- https://github.com/shilohbradley: An IR Person from UNLV with profile includes some code for IPEDS analysis.
- https://github.com/jasonpcasey: Some intersting higher-ed datasets, seems like an IR person.
- https://github.com/unl-iea: University of Nebraska IR
- https://github.com/MIT-IR: MIT IR, not much thats useful
- https://github.com/nietsnel/institutional-research: An older repo explaining the value of R for an IR team
- https://github.com/owid/covid-19-data/tree/master/public/data COVID-19 Data
- Somebody with the handle jbryer crearted a R library for downloading data from IPEDS. The code is here, if you look at the issues you'll see a few people have run into a problems and have asked for help.
- I use my personal Github account to share code that I think might be useful to others. The examples below show projects that have comments, issues, and have been used by other people. I posted a project for visualing the output from a kind of neural network here. That public repository attracted some conversation here. At one point the code broke and some guy in the Netherlands fixed it. By clicking on number next to the fork symbol one can see who has been using the code.
- Exercise 1 involves adding a file to this repository
- Exercise 2 involves collectively editing a file by creating a branch, submitting a pull request, and creating an issue. Do not begin exercise 2 until its your turn, you will recieve a notification to start.
- I created a little youtube video demonstrating how to use GitHub within viual studio here