01-handson_github_website.qmd

---
title: "Using the GitHub website"
---


In this section, we will be using the github.com website and demonstrate that you do not need to be a programmer to use version control and edit files on GitHub.

::: {.callout-note collapse=true}
### Don't have a GitHub account?

If you have not already created a GitHub username, please do so now:

- GitHub: <https://github.com>
- Follow optional [advice on choosing your username](https://happygitwithr.com/github-acct.html)
:::

::: {.callout-tip}

### Our asks

### As a Team of two

- Help each other, everyone is bringing different skills! Talk it out!
- Listen to each other; avoid judgment and solutioneering.
- Have fun!

### Prompt

We want to log the information about people's favorite desserts using a repository.
:::


#### Person 1 (owner):

- Create a repository using the  following these [instructions](https://docs.github.com/en/github/getting-started-with-github/create-a-repo) steps 1-6

![](img/github-dessert-repo.png)

- Edit the README to:
   - Replace the title (first line starting with `#`) with something better! Maybe `Favorite Desserts`
   - Add your name and your favorite dessert below the title: e.g.  ` - Julien: crepes`

```{r echo=FALSE}
knitr::include_graphics("img/github-readme_desserts.png")
```

- Add Person 2 as a collaborator following these [instructions](https://docs.github.com/en/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository)


#### Person 2 (collaborator): 

- Check your email to accept the invitation
- Go to the repository website (link is provided in the invitation)
- Start editing the README.md by clicking on pen at the top of the README.md file to edit it

```{r echo=FALSE}
knitr::include_graphics("img/github-readme-edit.png")
```

- Add your name and your favorite dessert below the title: e.g.  ` - Sophia: chocolate`
- Click _Commit changes_
- Add a descriptive commit message, "add my favorite dessert"


```{r echo=FALSE}
knitr::include_graphics("img/github-commit.png")
```

- Click _Commit changes_ to confirm

```{r commit-button, out.width="20%", echo=FALSE}
knitr::include_graphics("img/github-commit-button.png")
```


#### Person 1: add a file

Download this [csv file](https://aurora.nceas.ucsb.edu/~brun/favorite_desserts.csv) about your favorite desserts to your computer

- Just drag and drop it on the Github web page of your repository to upload it
- Add a short message about the file e.g. `Adding dessert csv` & hit `Commit changes`
- Your have has been uploaded. Click on the filename to see it!

You should have something similar to this repo: <https://github.com/brunj7/favorite-desserts>


#### Bonus 

Person 2: Try to edit the csv file directly on GitHub! 

Person 1: Your turn!

**No need to be a programmer to contribute to analytical workflows with GitHub!!**