# Week 05: GitHub for Collaboration

====

If you are new to HackMD, please see this short guide: [https://hackmd.io/@ols-4/hackmd-guide](https://hackmd.io/@ols-4/hackmd-guide)

This is an optional cohort call for folks who are new to GitHub.
If you have previously worked with GitHub, you can still attend the call as a helper.
Please contact the Open Life Science team to let them know your interest in co-facilitating the session.

====

## Before this call

- Please create a GitHub account: [https://github.com](https://github.com)
- Have a look at the OLS-4 repository for 'project issues': https://github.com/open-life-science/ols-4/issues
- Comment of 1-2 project's recent post (vision, open canvas etc.)
- Create your 'project issue' [as described here](https://www.youtube.com/watch?v=UG5TAIU6IVM)

## At this call

we will give you a short 1.5 hour GitHub tutorial:

- Creating a new repository
- Creating a (README) file: Writing in Markdown
- Managing issues and labels
- Enabling a small website via GitHub
- Submit changes (to the OLS-4 repository) via Pull Request (PR)
- Setting the scene for self-paced learning after this session
- Demo: Review PR and additional features to look at

## Join the call

- Please note that this call will be recorded
- The video will be available on the YouTube channel ([https://www.youtube.com/c/OpenLifeSci)](https://www.youtube.com/c/OpenLifeSci)) in the next days
- Turn on your webcam if you don’t mind sharing your face (or off if you do!)
- Please edit your Zoom name (click on the three dots on the top right of your video) and add one of the following letters in front of your name.
- **W** for written reflection-based exercise in the main room
- **S** for Spoken Discussion Breakout Room This will help us assign you to the breakout room with the format of your choice
- If you are ok with both, please choose one for this week so that the hosts can assign you to a breakout room during the cohort call

## Roll call: The session facilitators will add your name before you edit it.

- *Name / Icebreaker question: Share something from nature that has awed you or brought you joy recently - perhaps a flower, a view, a photo, a scent, a potted plant, a bird that flew past...*
* Name 1 /
* Name 2 /
* Name 3 /
* Name 4 /
* Name 5 /
* Name 6 /
* Name 7 /
* Name 8 /
* Name 9 /
* Name 10 /
* Name 11 /
* Name 12 /
* Name 13 /
* Name 14 /
* Name 15 /
* Name 16 /
* Name 17 /
* Name 18 /
* Name 19 /
* Name 20 /
* Name 21 /
* Name 22 /
* Name 23 /
* Name 24 /
*

🗣️ Welcome!

* Reminder: Code of conduct & community participation guidelines
* If you experience or witness unacceptable behaviour, or have any other concerns, please report it by contacting the organisers - Bérénice, Emmy, Malvika, and Yo. ([e-mail]).
* To report an issue involving one of the organisers, please email one of the members individually ([e-mail], [e-mail], [e-mail], [e-mail]).

🛠 Introduction to GitHub

- Slides: [GitHub for Collaboration](https://docs.google.com/presentation/d/1qymN0F-kToQfFIPjXOrXe7lHPy_UB0Buew2kAI1WfWg/edit?usp=sharing)
- Training materials: https://malvikasharan.github.io/developing_collaborative_document/
- Cheatsheet: https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf

## Pull Request (PR) Exercise: Breakout-1

After the facilitators have demo-ed how to create PR:
- Visit the GitHub file for this work: https://github.com/open-life-science/ols-4/week-05-notes.md
- Edit the file by adding details next to your name (click on the pencil symbol)
- Commit 'on a new branch' -> create your Pull Request

## Creating a GitHub page (website): Breakout-2

After the facilitators have demo-ed how to create a minimal website/Git page:
- Visit the GitHub reprository that you created
- Edit the GitHub sessting to active Git Pages option and save it
- Copy the link for your Git Page ([GitHub User Name].[github.io/].[repository name]) and open it on your browser

## Questions / Comments?
-
-

:pray: Closing
---

- Next cohort call: February 26, 2:00 - 3:30 pm CET ([time zone](https://arewemeetingyet.com/Berlin/2020-02-26/14:00/OLS-1%20Cohort%20Call%20(Week%206)))

### GitHub Resources

- [Mozilla Science Lab's Study Group Orientation](https://mozillascience.github.io/study-group-orientation/) and [Friendly GitHub Intro by Kirstie Whitaker](https://github.com/KirstieJane/friendly-github-intro)
- Visual description: [https://learngitbranching.js.org/](https://learngitbranching.js.org/) (great resource for learning Git!)
- Useful GitHub resources
- [GitHub for Collaboration (from Mozilla)](https://mozilla.github.io/open-leadership-training-series/articles/github-for-collaboration/)
- [Understanding the GitHub workflow](https://guides.github.com/introduction/flow/)
- [A Friendly Github Intro Workshop (from Danielle Robinson)](https://daniellecrobinson.github.io/friendly-github-intro/)
- [GitHub help](https://help.github.com/)
- [Oh Shit, Git!?!](http://ohshitgit.com/)
- [Try Git](https://try.github.io/)
- [Git book](https://git-scm.com/book/en/v2)
- [GitHub glossary](https://github.com/joeyklee/friendly-github-intro/blob/master/glossary.md)
- [Writing on Github](https://help.github.com/categories/writing-on-github/)
- [Markdown Cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)
- [Git workflow](https://www.atlassian.com/git/tutorials/comparing-workflows)

### Open Q & A time
-
-
-

### Feedback

#### What worked?
-
-

#### What didn't worked?
-
-

#### What would you change?
-
-

#### What surprised you?
-
-

License: CC BY 4.0, Open Life Science (OLS), 2021

*Reference*: Open Life Science, License*: CC BY 4.0, The Turing Way*