geoss / shared-skills-git

Learning to use Github for documentation, collaboration, revision and version control

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

shared-skills-git

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.

Setup

  1. Install Visual Studio Code here
  2. 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
  1. 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

Explore

  1. Explore to get a sense of what of what Github and how its used. I found a few interesting repositiories:
  1. 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.
  2. 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.

Do Stuff

  1. Exercise 1 involves adding a file to this repository
  2. 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.

Additional resources

  1. I created a little youtube video demonstrating how to use GitHub within viual studio here

About

Learning to use Github for documentation, collaboration, revision and version control