Commit 5ea3f473 authored by Laurent Heirendt's avatar Laurent Heirendt
Browse files

adding new slides for quality talk

parent 78f57ec7
......@@ -6,14 +6,23 @@
"filename": "overview.md"
},
{
"filename": "the_terminal.md"
"filename": "wheel.md"
},
{
"filename": "the_editor.md"
"filename": "repro_crisis.md"
},
{
"filename": "whyCare.md"
},
{
"filename": "what_is_git.md"
},
{
"filename": "the_terminal.md"
},
{
"filename": "the_editor.md"
},
{
"filename": "installation.md"
},
......
## Overview
0. The terminal
1. The editor
2. What is `git`? What is the use of `git`? <!--(5 min)//-->
3. Installation of `git`
4. GitHub and GitLab <!--(5min)//-->
5. How do I configure `git`? <!--(5min)//-->
6. Where and how to start? <!--(5min)//-->
7. What is a fork? <!--(5min)//-->
8. What are branches?
9. The 5 essential commands <!--(10 min)//-->
* `pull` / `status` / `add` / `commit` / `push`
10. What are merge/pull requests? <!--(10 min)//-->
11. How do I synchronize my fork?
12. Best practices
\ No newline at end of file
1. **PART I**: Quality of computer code.
2. **PART II**: Basic git course
1. The terminal
2. The editor
3. What is `git`? What is the use of `git`? <!--(5 min)//-->
4. Installation of `git`
5. GitHub and GitLab <!--(5min)//-->
6. How do I configure `git`? <!--(5min)//-->
7. Where and how to start? <!--(5min)//-->
8. What is a fork? <!--(5min)//-->
9. What are branches?
10. The 5 essential commands (`pull` / `status` / `add` / `commit` / `push`)
11. What are merge/pull requests? <!--(10 min)//-->
12. How do I synchronize my fork?
13. Best practices
\ No newline at end of file
## Reproducibility crisis
<div align="center">
<img src="slides/img/reproCrisis.png">
</div>
*Baker, M., <a href="https://www.nature.com/news/1-500-scientists-lift-the-lid-on-reproducibility-1.19970">1,500 scientists lift the lid on reproducibility</a>, Nature 533, 452–454, 2016. doi:10.1038/533452a*
\ No newline at end of file
## PART II
<br><br><h1>Basic git course</h1>
## The terminal (shell)
**UNIX users (macOS & Linux):**
......
## PART I
<br><br><h1>Quality of computer code.</h1><br>
<h1>Should you care? What if you didn't?</h1>
## A true story ...
<div align="center">
<img src="slides/img/wheel.png">
</div>
<table style="width:100%">
<tr>
<th width="33%" align="center">Researcher who cares about<br>quality of his code</th>
<th width="33%" align="center">Fellow researcher</th>
<th width="33%" align="center">Pi or Manager</th>
</tr>
</table>
\ No newline at end of file
## Why you should care (1)
<div align="center">
<video width="40%" controls>
<source src="slides/img/arianeLaunch.mov" type="video/mp4">
Your browser does not support the video tag.
</video>
</div>
**Aerospace Application**: First launch of Ariane 5, 1996
<font color="#A52A2A"><span class="fas fa-times-circle"></span></font> **Problem**: Rocket exploded shortly after liftoff.
<font color="#FFA500"><span class="fas fa-exclamation-triangle"></span></font> **Root cause of disaster - Software error:**
Horizontal velocity of the rocket exceeded the limits of the 16-bit signed integer value and led to overflow
Ariane 5 launched with the same software as Ariane 4 - **the code had not been tested**
## Why you should care (2)
<div align="center">
<img src="slides/img/therac.png">
</div>
**Biotechnology Application**: Therac-25 – computer controlled radiation therapy machine
<font color="#A52A2A"><span class="fas fa-times-circle"></span></font> **Problem**: Device malfunctions and delivers a lethal dose of radiation - several patients died.
<font color="#FFA500"><span class="fas fa-exclamation-triangle"></span></font> **Root cause of disaster - Software error:**
**No testing** of software before release, **lack of documentation**
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment