---
# System prepended metadata

title: 'Week 05: GitHub for Collaboration'

---

# 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. (team@openlifesci.org).
* To report an issue involving one of the organisers, please email one of the members individually (berenice@openlifesci.org, malvika@openlifesci.org, yo@openlifesci.org, emmy@openlifesci.org).

🛠 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*
