07b_github.qmd

---
title: "Get to know GitHub"
author: "Dr Anna Krystallli" 
subtitle: "Reproducible Research Data and Project Management in R" 
institute: R-RSE 
materials_url: https://acce-rrresearch.netlify.app/ 
format:
  revealjs: 
    logo: assets/logo/r-rse-logo2.png
    theme: [default, assets/css/styles.scss, assets/css/reveal.scss]
    footer: "[{{< fa home >}}](index.qmd)"
    from: markdown+emoji
    template-partials:
      - assets/layouts/title-slide.html
editor: visual 
preload-iframes: true
lightbox: true
---

# **GitHub features**

## Back up and sync through the cloud

![Image: Jessica Lord, 2013 BSD](assets/remotes.png){width="800"}

## Fork and contribute to other's work

![Image: Jessica Lord, 2013 BSD](assets/clone.png){width="800"}

## **GitHub for science**

> -   ideal for managing the full suite of research outputs such as datasets, statistical code, figures, lab notes, and manuscripts.

> -   supports peer review, commenting, and discussion.

> -   Diverse range of efforts, from individual to large bioinformatics projects, laboratory repositories, as well as global collaborations have found a home on GitHub

## Remote repositories

centralising information e.g. [**weecology** / ***"Nine simple ways to make it easier to (re)use your data" paper***](http://ojs.library.queensu.ca/index.php/IEE/article/view/4608/0) \| [Repo](https://github.com/weecology/data-sharing-paper)

```{r, out.width="80%", echo=FALSE}
knitr::include_graphics("assets/repo-1.png")
```

## Commits

Traceability. **Entire process of project evolution reproducible.**

#### [Repo](https://github.com/ropensci/rfishbase/commits/master)

![](assets/commits-1.png)

## Issues

Project management

### [Repo](https://github.com/weecology/data-sharing-paper/issues)

![](assets/issues-1.png)

# **Practical: Github & Rstudio for collaborative coding**

## **#EvoLottery**

**Beak and skull shapes in birds of prey (“raptors”) are strongly coupled and largely controlled by size.**

-   In this exercise, each participant will **fork a github repo**, and **contribute a file** required to simulate the *evolutionary trajectory of an imaginary species' body size*.

-   We'll use **github** to **collate all species files** and **plot** them all up together at the end! We'll also **discover the skull and beak shapes** associated with each simulated species size.

### [**Enter Practical**](evolottery.qmd)

### See [**Collaborative Report**](https://r-rse.github.io/evolottery/plot_trait_evolution.html)

# Get back [{{< fa home >}}](index.qmd)