====== Collaborating with GitHub ======

===== Creating a GitHub account =====
  - Create a GitHub account: [[https://github.com/join]]
  - Apply for a student discount: [[https://education.github.com/pack]]
  - Join CardiffUniversityGravitationalPhysics: [[https://github.com/CardiffUniversityGravitationalPhysics]]

===== Creating a new Repository =====
  * Create a new repository: [[https://github.com/new]]
  * Decide whether it is public or private, and whether GitHub should add README, .gitignore and license
  * The repository home page shows the URL for this project under "Clone or download".
  * To clone it to your laptop run, e.g.:<code bash>
git clone https://github.com/alberteinstein/MyProject.git
</code>
  * Make changes to your project using ''git add'', ''git commit'' as before.
  * Then you can push these changes up to GitHub:<code bash>
git push -u origin master
</code>
  * Note the ''-u'' flag is short for ''--set-upstream'' and you only need to do it once. This allows you to run ''git pull'' without specifying the branch name each time.

===== Pushing an existing Repository =====
  * Create a GitHub repository as above, but do not create README, .gitignore etc.
  * Copy and paste the URL.
  * On your laptop go to the existing repository and add it as a new remote:<code>
git remote add origin https://github.com/alberteinstein/MyProject.git
</code>
  * Push your repository up to GitHub using:<code bash>
git push origin master
</code>

===== Forking an Existing Project =====
  * On the project GitHub page click the fork button.
  * The repository home page shows the URL for this project under "Clone or download".
  * To clone it to your laptop run, e.g.:<code bash>
git clone https://github.com/alberteinstein/TheProject.git
</code>
  * Make changes to your project using ''git add'', ''git commit'' as before.
  * Then you can push these changes up to your GitHub:<code bash>
git push -u origin master
</code>
  * To keep up-to-date with the original project first add it as a remote<code>
git remote add upstream https://github.com/theteam/TheProject.git
</code>
   * Then fetch the new data and sync it with your changes:<code bash>
git fetch upstream
git checkout master
git merge upstream/master
</code>
   * Push your repository up to GitHub using:<code bash>
git push origin master
</code>