Skip to content

Commit 2832926

Browse files
authored
insert mermaid closes #1801
1 parent 1876cb1 commit 2832926

1 file changed

Lines changed: 49 additions & 2 deletions

File tree

episodes/08-motivation.md

Lines changed: 49 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,13 +67,44 @@ things in the opposite corner
6767
that are time-consuming to learn and have little near-term application
6868
should be avoided in our workshops.
6969

70-
![](fig/what-to-teach.png){alt='A stylised graph with y-axis labeled "usefulness once mastered" and and x-axis labeled "mean time to master". The upper left quadrant says "teach this first" and the lower right quadrant says "do not bother".'}
70+
```mermaid
71+
%%{init: {"quadrantChart": {"xAxisPosition": "bottom"}, "themeVariables": {} }}%%
72+
%%accDescr {A quandrant chart, 2x2 grid, with y-axis labeled quick to master --> slow to master and and x-axis labeled used rarely --> used frequently. The upper left quadrant says "teach this first" and the lower right quadrant says "do not bother"}
73+
quadrantChart
74+
title When to teach
75+
x-axis quick to master --> slow to master
76+
y-axis used rarely --> used frequently
77+
quadrant-2 Teach this first
78+
quadrant-4 Do not bother
79+
80+
```
7181

7282
Another way to think about the graph shown above is **authentic tasks** -- real tasks performed
7383
by someone doing their work. If you can identify authentic tasks from your
7484
own work that could be useful to others, these examples will be highly
7585
motivating.
7686

87+
This 2x2 grid can be useful for longer term lesson planning and development as well as for considering how to answer questions. To make the ideas more concrete, here is an example in the context of driving:
88+
89+
```mermaid
90+
%%{init: {"quadrantChart": {"xAxisPosition": "bottom"}, "themeVariables": {} }}%%
91+
quadrantChart
92+
title When to teach
93+
x-axis quick to master --> slow to master
94+
y-axis used rarely --> used frequently
95+
quadrant-2 Teach this first
96+
quadrant-4 Do not bother
97+
quadrant-1 Teach later
98+
quadrant-3 Offer if needed
99+
A -Driving around an empty carpark.: [0.2, 0.8]
100+
B - Drive at speed on a Formula 1 racing track : [0.85, 0.25]
101+
C - Driving on suburban roads: [0.8, 0.8]
102+
D - Driving with snow chains.: [0.2, 0.15]
103+
%%accDescr {A quandrant chart, 2x2 grid, with y-axis labeled quick to master --> slow to master and and x-axis labeled used rarely --> used frequently. The upper left quadrant says "teach this first" and the lower right quadrant says "do not bother"}
104+
```
105+
106+
An empty carpark is a great place to start for any new driver, but most people will never drive at speed in a race track. In contrast, suburbans road are a realistic motivating example that any driver will encounter. That will be on the agenda for a driving school. Driving with snow chains is important if you live in a place that gets extreme snow events, but not for most people. That is something that someone can learn later if they need it, or an individual who lives or frequently visits a place where they are common may even know to ask about, but most people will not need. We would not want a lesson to go from an empty carpark to snow chains because we would probably lose a lot of people.
107+
77108
::::::::::::::::::::::::::::::::::::::: challenge
78109

79110
## Authentic Tasks: Think, Pair, Share
@@ -82,11 +113,27 @@ motivating.
82113
(e.g. wrote a function, bulk downloaded data, built a plot in R, forked a repo)
83114
and explain how you would use it (or a simplified version of it) as an exercise or example in class.
84115
**Pair** up with your neighbor and decide where this exercise fits on a graph of "short/long time to master" and "low/high usefulness".
85-
In the class Etherpad, **share** the task and where it fits on the graph.
116+
In the class Etherpad, **share** the task and where it fits on the graph, using the lettered points in the diagram below.
86117
As a group, we will discuss how these relate back to our "teach most immediately useful first" approach.
87118

88119
This exercise should take about 10 minutes.
89120

121+
```mermaid
122+
%%{init: {"quadrantChart": {"xAxisPosition": "bottom"}, "themeVariables": {} }}%%
123+
quadrantChart
124+
title When to teach
125+
x-axis quick to master --> slow to master
126+
y-axis used rarely --> used frequently
127+
quadrant-2 Teach this first
128+
quadrant-4 Do not bother
129+
quadrant-1 Teach later
130+
quadrant-3 Offer if needed
131+
topic A: [0.2, 0.8]
132+
topic B : [0.85, 0.25]
133+
topic C: [0.8, 0.8]
134+
topic D: [0.2, 0.15]
135+
accDescr {A quandrant chart, 2x2 grid, with y-axis labeled quick to master --> slow to master and and x-axis labeled used rarely --> used frequently. The upper left quadrant says "teach this first" and the lower right quadrant says "do not bother"}
136+
```
90137

91138
::::::::::::::::::::::::::::::::::::::::::::::::::
92139

0 commit comments

Comments
 (0)