Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add process questions and deming cycle #26

Merged
merged 5 commits into from
Dec 14, 2023
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 46 additions & 1 deletion episodes/introduction.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@

Our vision for this workshop is to increase the awareness of good practices that will increase the reproducibility of data analysis workflow that already uses R and Git.

![Our vision: Increase the awareness of good practices that complement an R and Git workflow](fig/goal-intro.png)

Check warning on line 33 in episodes/introduction.Rmd

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

[image missing alt-text]: fig/goal-intro.png

## What can we do?

Expand All @@ -43,9 +43,54 @@
- 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 to remove the focus on human error and be aware that processes can fail people with good intentions, and we can enter a cycle of continuous improvement.
avallecam marked this conversation as resolved.
Show resolved Hide resolved

> "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
the concept of human error. The seminal book
_The Field Guide to Understanding Human Error_
argues for a paradigm shift from the “Old World View” (that
when an error occurs it is an individual actor’s fault) to the “New World View”
(that when an error occurs, it is a symptom of a flawed system that failed that
individual actor) (Dekker 2014). When an error in an analysis occurs, it is safe
to assume (aside from nefarious actors) that the analyst did not want that error
to occur. Given that she thought she was producing an analysis free from errors,
you must look at the way she developed the analysis to understand where the
error occurred, and create safeguards so that the error does not occur again." ([Parker, 2017a](https://sachsmc.github.io/rpackage-workshop/opinionated-analysis-dev.pdf) and [Parker, 2017b](https://posit.co/resources/videos/opinionated-analysis-development/))

Repetitive events (like outbreak response and research data analysis projects) give us the opportunity to:

- Focus on the **process** we have followed,
- Evaluate **where** bottlenecks occur, and then
- **Adopt** new practices to be better protected against errors in the next iteration.

::::::::::::::::: callout

### Deming Cycle

This approach aims to follow a [Deming cycle](https://www.lean.org/lexicon-terms/pdca/) of Plan, Do, Check, and Act, as a foundation for continuous improvement.

:::::::::::::::::::::::::

::::::::::::::::: discussion

Exercise: Your experience analyzing outbreak data (the latest... or the most chaotic!)

Take 5 minutes.

Reflect on these questions:

- How do you organize your files and folders?
avallecam marked this conversation as resolved.
Show resolved Hide resolved
- Where does it describe what your project did or how to use it? Was it all in one place?
avallecam marked this conversation as resolved.
Show resolved Hide resolved
- Could your project be reused by colleagues? Do you think it is?
avallecam marked this conversation as resolved.
Show resolved Hide resolved

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:
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.
Expand Down
Loading