diff --git a/episodes/introduction.Rmd b/episodes/introduction.Rmd index 26618cc..bce663e 100644 --- a/episodes/introduction.Rmd +++ b/episodes/introduction.Rmd @@ -32,18 +32,7 @@ Our vision for this workshop is to increase the awareness of good practices that ![Our vision: Increase the awareness of good practices that complement an R and Git workflow](fig/goal-intro.png) -## What can we do? - -A fair strategy to follow is to gradually incorporate good practices in scientific computing ([Wilson et al. 2017](https://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1005510)) that include: - -- Data management, -- Software development, -- Collaboration, -- Project organization, -- Keep track of changes, and -- Manuscript writing. - -But before incorporating any new practice, first, we can evaluate the **processes** we are following. A process-centred approach helps us remove the focus on human error, be aware that processes can fail people with good intentions, and accept that we can enter a continuous improvement cycle. +The figure above helps us to visualize and potentially evaluate the **processes** we are following. A process-centred approach helps us remove the focus on human error, be aware that processes can fail people with good intentions, and accept that we can enter a continuous improvement cycle. > "By defining the process, we can begin to borrow from the rich field of operations, which focuses primarily on (the) process. One paradigm that proves especially useful is @@ -88,15 +77,17 @@ Share one idea from your neighbour. :::::::::::::::::::::::::::: -## How can we start? -Our plan for this workshop is to prioritize three tools, given their [usefulness once mastered and the time to master them](https://teachtogether.tech/en/index.html#s:motivation-authentic): +## What can we do? -- Use research compendium templates. -- Make reproducible analysis. -- Write informative READMEs. +A fair strategy to follow is to **gradually** incorporate good practices in scientific computing ([Wilson et al. 2017](https://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1005510)) that include: -We'll relate relevant features for Sustainable software, Reproducible research, and Open science for each tool. +- Data management, +- Software development, +- Collaboration, +- Project organization, +- Keep track of changes, and +- Manuscript writing. :::testimonial @@ -110,6 +101,16 @@ We support the opinion of [Jaime Quinn](https://sorse.github.io/blog/a-reproduci ::: +## How can we start? + +Our plan for this workshop is to prioritize three tools, given their [usefulness once mastered and the time to master them](https://teachtogether.tech/en/index.html#s:motivation-authentic): + +- Use research compendium templates. +- Make reproducible analysis. +- Write informative READMEs. + +We'll relate relevant features for Sustainable software, Reproducible research, and Open science for each tool. + ::::::::::::::::::::::::::::::::::::: keypoints - Our vision is to increase the awareness of tools to improve the reproducibility of data analysis.