Skip to content

Commit 4c81876

Browse files
authored
Merge branch 'main' into community-role-links
2 parents 2c5bc67 + 9a11276 commit 4c81876

31 files changed

Lines changed: 224 additions & 169 deletions

README.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -15,18 +15,16 @@ If you want to preview this lesson locally, you will need the [{sandpaper} R pac
1515

1616
- [Sarah Brown][brown_sarah]: @brownsarahm
1717
- [Nathaniel Porter][porter-nathaniel]: @ndporter
18+
- [Karen Cranston][cranston-karen]: @kcranston
1819
- [Jon Wheeler][wheeler_jon]: @jonathanwheeler01
19-
- [Karen Word][word_karen]: @karenword
2020

2121
[swc-site]: https://software-carpentry.org
2222
[dc-site]: https://datacarpentry.org
2323
[lc-site]: https://librarycarpentry.org
2424
[lesson-doc]: https://carpentries.github.io/sandpaper-docs
25-
[brown_sarah]: https://carpentries.org/instructors/#brownsarahm
26-
[perez-suarez_david]: https://carpentries.org/instructors/#dpshelio
27-
[porter-nathaniel]: https://carpentries.org/instructors/#ndporter
28-
[wheeler_jon]: https://carpentries.org/instructors/#jonathanwheeler01
29-
[word_karen]: https://carpentries.org/team/
30-
25+
[brown_sarah]: https://github.com/brownsarahm
26+
[porter-nathaniel]: https://github.com/ndporter
27+
[wheeler_jon]: https://github.com/jonathanwheeler01
28+
[cranston-karen]: https://github.com/kcranston
3129

3230

episodes/01-welcome.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,7 @@ in the Etherpad below to write a short response to the last question.
139139

140140
1. Yes, I have taken a workshop.
141141
2. Yes, I have been a workshop helper.
142-
3. Yes, I organized a workshop.
142+
3. Yes, I organised a workshop.
143143
4. No, but I am familiar with what is taught at a workshop.
144144
5. No, and I am not familiar with what is taught at a workshop.
145145

@@ -162,7 +162,7 @@ This exercise should take about 5 minutes for responses, with an optional 10 for
162162

163163
To make sure everyone has the
164164
same context, we will give a brief overview of The Carpentries
165-
organization before starting the training.
165+
organisation before starting the training.
166166

167167
## A Brief Overview of The Carpentries
168168

episodes/02-practice-learning.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ these principles are put into practice in Carpentries workshops.
2727
## The Carpentries Pedagogical Model
2828

2929
The Carpentries aims to teach computational competence to learners. We
30-
take an applied approach, avoiding the theoretical and general in favor
30+
take an applied approach, avoiding the theoretical and general in favour
3131
of the practical and specific. By showing learners how to solve specific
3232
problems with specific tools and providing hands-on practice, we develop
3333
learners' confidence and lay the foundation for future learning.
@@ -127,7 +127,7 @@ seize up or break down entirely as new concepts are added.
127127

128128
### The power (and limitations) of analogies
129129

130-
Some mental models can be succinctly summarized by comparison to
130+
Some mental models can be succinctly summarised by comparison to
131131
something else that is more universally understood. Good analogies can
132132
be extraordinarily useful when teaching, because they draw upon an
133133
existing mental model to fill in another, speeding learning and making a
@@ -138,7 +138,7 @@ to generate misconceptions that may interfere with learning.
138138
::: challenge
139139
## Analogy Brainstorm
140140

141-
1. Think of an analogy to explore. Perhaps you have a favorite that
141+
1. Think of an analogy to explore. Perhaps you have a favourite that
142142
relates to your area of professional interest, or a hobby. If you
143143
prefer to work with an example, consider this analogy from
144144
education: "teaching is like gardening."
@@ -162,7 +162,7 @@ drywall."
162162

163163
The word "carpentry" acts as a metaphor -- a type of analogy --
164164
inspiring a comparison with something concrete, hands on, practical, and
165-
useful. This clearly conveys the purpose of our organization: to support
165+
useful. This clearly conveys the purpose of our organisation: to support
166166
computational skill development among working practitioners who need the
167167
right tools and practices to be effective day to day.
168168
:::
@@ -192,7 +192,7 @@ Returning to our example levels of skill development:
192192
difficulty explaining how they are thinking in ways that do not rely
193193
on other features unique to their own mental model.
194194

195-
![](fig/mental_models.svg){alt="Three collections of six circles. The first collection is labelled \"Novice\" and has only two arrows connecting some of the circles. The second collection, labelled \"Competent Practitioner\" has six connecting arrows. The third collection, labelled \"Expert\", is densly connected, with eight connecting arrows."}
195+
![](fig/mental_models.svg){alt="Three collections of six circles. The first collection is labelled \"Novice\" and has only two arrows connecting some of the circles. The second collection, labelled \"Competent Practitioner\" has six connecting arrows. The third collection, labelled \"Expert\", is densely connected, with eight connecting arrows."}
196196

197197
### Mapping a Mental Model
198198

@@ -213,18 +213,18 @@ activity. It can be helpful to make a larger map and then narrow down to
213213
a smaller one.
214214
:::
215215

216-
Most people do not naturally visualize a mental model as a diagram of
216+
Most people do not naturally visualise a mental model as a diagram of
217217
concepts and relationships. Mental models are complicated! Yet, visual
218218
representation of concepts and relationships can be a useful way to
219219
explore and understand hidden features of a mental model.
220220

221-
There are certain ways in which you may routinely use visual organizers,
221+
There are certain ways in which you may routinely use visual organisers,
222222
such as flow charts or biochemical pathway diagrams. A more general tool
223223
that is useful for exploring any network of concepts and relationships
224224
is a **concept map**. Pioneered for classroom use by John Novak in the
225225
1970s, a concept map asks you to identify which concepts are most
226226
relevant to a topic at hand and -- critically -- to identify how they
227-
are connected. It can be quite difficult to identify and organize these
227+
are connected. It can be quite difficult to identify and organise these
228228
connections! However, the process of forcing abstract knowledge into a
229229
visual format can force you to name connections that you might otherwise
230230
have quietly assumed, or illuminate gaps that you may not have been

episodes/04-expertise.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -56,13 +56,13 @@ This discussion should take about 5 minutes.
5656

5757
In reviewing the answers to the question above you will find that the expert
5858
experience amounts to much more than just knowing more facts.
59-
Competent practitioners can memorize a lot of information
59+
Competent practitioners can memorise a lot of information
6060
without any noticeable improvement to their performance.
6161
So, what makes an expert? The answer is that
6262
experts have **more connections among pieces of knowledge** that help them think and problem-solve quickly;
6363
more "short-cuts", if you will.
6464

65-
![](fig/mental_models.svg){alt='Three collections of six circles. The first collection is labelled "Novice" and has only two arrows connecting some of the circles. The second collection, labelled "Competent Practitioner" has six connecting arrows. The third collection, labelled "Expert", is densly connected, with eight connecting arrows.'}
65+
![](fig/mental_models.svg){alt='Three collections of six circles. The first collection is labelled "Novice" and has only two arrows connecting some of the circles. The second collection, labelled "Competent Practitioner" has six connecting arrows. The third collection, labelled "Expert", is densely connected, with eight connecting arrows.'}
6666

6767
This brings us back to our mental model diagrams,
6868
where facts are nodes and relationships are arcs.
@@ -200,7 +200,7 @@ This discussion should take about 5 minutes. (Optionally, this may be discussed
200200
## "Just" and Other Dismissive Language
201201

202202
Instructors want to motivate learners! We will talk more about motivation in a later episode. But here,
203-
we will take a moment to recognize one *ineffective* strategy often deployed by experts who
203+
we will take a moment to recognise one *ineffective* strategy often deployed by experts who
204204
want learners to *believe that a task is as easy as they think it is.* This often manifests
205205
in using the word "just" in explanations,
206206
as in, "Look, it is easy, you just... (*wave magic wand with undecipherable incantations*)"
@@ -252,7 +252,7 @@ people will, indeed, have questions, and should challenge themselves to formulat
252252

253253
As you seek to re-acquaint yourself with the novice experience, it can be tempting to think back to your own
254254
experiences getting started in programming. Trips down memory lane can be productive! However, it is important that
255-
you take care not to generalize from your experience to that of your novice learners.
255+
you take care not to generalise from your experience to that of your novice learners.
256256

257257
We will talk more about knowing your audience in a later episode. For now, here are
258258
two points to keep in mind when contemplating the learner experience:

episodes/05-memory.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ This exercise should take about 5 minutes.
7272

7373
## Test Your Working Memory - Analog version (5 min)
7474

75-
Read the following list and try to memorize the items in it:
75+
Read the following list and try to memorise the items in it:
7676

7777
cat, apple, ball, tree, square, head, house, door, box, car, king,
7878
hammer, milk, fish, book, tape, arrow, flower, key, shoe
@@ -128,7 +128,7 @@ This exercise should take about 5 minutes.
128128

129129
::::::::::::::::::::::::::::::::::::::::::::::::::
130130

131-
![](fig/chunking2.png){alt='A list of words: cat, apple, ball, tree, square, head, house, door, box, car, king, hammer, milk, fish, book, tape, arrow, flower, key, shoe.Underneath, the same words are organized into boxes with related terms e.g. cat fish milk ball and apple flower tree"'}
131+
![](fig/chunking2.png){alt='A list of words: cat, apple, ball, tree, square, head, house, door, box, car, king, hammer, milk, fish, book, tape, arrow, flower, key, shoe.Underneath, the same words are organised into boxes with related terms e.g. cat fish milk ball and apple flower tree"'}
132132

133133
Associating concepts
134134
reduces the number of effective
@@ -265,7 +265,7 @@ which are intended to be completed together, through participatory live coding (
265265
later in this training).
266266

267267
The choices you make as an Instructor may add to or subtract from your learners' cognitive load. Supporting memory consolidation
268-
can reduce load later on in the workshop, as it reduces the effort of recalling forgotten material. You can also minimize
268+
can reduce load later on in the workshop, as it reduces the effort of recalling forgotten material. You can also minimise
269269
cognitive load by choosing formative assessments that are
270270
narrowly focused and by considering potential distractions in what you display during instruction.
271271

@@ -278,11 +278,11 @@ A few more that you may wish to consider are:
278278

279279
- [Faded examples][wikipedia-faded]: worked examples with targeted details "faded" out -- essentially fill-in-the-blank programming blocks
280280
- [Parson's Problems][wikipedia-parsons]: out-of-order code selection \& sorting challenges
281-
- Labelling diagrams or flow charts (may also be organized as a fill-in-the-blank)
281+
- Labelling diagrams or flow charts (may also be organised as a fill-in-the-blank)
282282

283-
Beware assessments that are too open-ended, as these are very likely to induce cognitive overload in novice learners! You may have experienced
283+
Beware of assessments that are too open-ended, as these are very likely to induce cognitive overload in novice learners! You may have experienced
284284
some overload already when you were asked to create a concept map; this is why we do not recommend these as an activity for novice learners. Questions
285-
that ask learners to both remember and synthesize or reason with new information are also risky. If you try out
285+
that ask learners to both remember and synthesise or reason with new information are also risky. If you try out
286286
a question and get a room filled with silence, you may need an icebreaker, you may need to re-teach... or you may only need a more narrowly focused question.
287287

288288
### What to Display
@@ -318,10 +318,10 @@ increasing connectivity (chunking) among new concepts can improve
318318
outcomes for subsequent memory-intensive exercises. Formative assessments, when performed
319319
frequently, help learners by prompting them to apply new content before it has been
320320
overwritten. Faded examples or other types of guided practice
321-
both minimize demands on short-term memory and offer context that
321+
both minimise demands on short-term memory and offer context that
322322
helps improve connectivity for future work, in which the "scaffolding" of contextual support
323323
can be gradually removed.
324-
Anything you can do to a) recognize and b) support learners in working with the
324+
Anything you can do to a) recognise and b) support learners in working with the
325325
limitations of short-term memory will improve the effectiveness of your teaching.
326326

327327
[wikipedia-7]: https://en.wikipedia.org/wiki/The_Magical_Number_Seven,_Plus_or_Minus_Two

episodes/06-feedback.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ all the questions, you can preview them in a text-format below:
4848
When The Carpentries Workshops and Instruction Team sets up the surveys for your workshop, they will also send you a link to
4949
a dashboard with the results! Take care not to share this link with your learners.
5050

51-
- The carpentries maintains a [dashboard](https://workshop-reports.carpentries.org/?aggregate-workshops) displaying data from past workshop surveys, so you can have an idea of what to expect for your workshop.
51+
- The Carpentries maintains a [dashboard](https://workshop-reports.carpentries.org/?aggregate-workshops) displaying data from past workshop surveys, so you can have an idea of what to expect for your workshop.
5252

5353
::::::::::::::::::::::::::::::::::::::: checklist
5454

@@ -62,7 +62,7 @@ you will receive all the survey results from your workshop participants.
6262

6363
::::::::::::::::::::::::::::::::::::::::::::::::::
6464

65-
![](fig/surveyscreenshot3.svg){alt='Screenshot of a workshop website showing location of customized survey links'}
65+
![](fig/surveyscreenshot3.svg){alt='Screenshot of a workshop website showing location of customised survey links'}
6666

6767
### Timing Matters
6868

@@ -78,12 +78,12 @@ opportunity to reflect), yourself (you will get more useful feedback), and The C
7878

7979
Before each long break, for example lunch or between days, we
8080
have learners complete **minute cards** to share anonymous feedback. At an in-person workshop,
81-
paper sticky notes double as minute cards, with the two different colors used for positive and
81+
paper sticky notes double as minute cards, with the two different colours used for positive and
8282
constructive feedback. At an online workshop, this may be done by making a copy of our [Virtual Minute Card Template](https://docs.google.com/forms/d/1p7iOV5HNvy4POS4g6eottY8RSfKq4kaoKz1-jIFYTMI/template/preview)
8383
on Google Forms. Other tools can work as well, but we do recommend making sure that feedback is private and
8484
anonymous. A public-facing sticky note board will receive different (and less useful) feedback.
8585

86-
Whatever method you use, you may wish to customize the prompt to elicit different types of feedback at each break.
86+
Whatever method you use, you may wish to customise the prompt to elicit different types of feedback at each break.
8787

8888
**Example positive prompts:**
8989

@@ -132,7 +132,7 @@ about how you are responding to learner feedback.
132132

133133
## Give Us Feedback
134134

135-
Write one thing you learned this so far in this training that you found useful on
135+
Write one thing you learned so far in this training that you found useful on
136136
your blue sticky note, and one question you have about the material
137137
on the yellow. Do *not* put your name on the notes: this is meant to
138138
be anonymous feedback. Add your notes to the pile by the door as

episodes/08-motivation.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ things in the opposite corner
6161
that are time-consuming to learn and have little near-term application
6262
should be avoided in our workshops.
6363

64-
![](fig/what-to-teach.png){alt='A stylized 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".'}
64+
![](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".'}
6565

6666
Another way to think about the graph shown above is **authentic tasks** -- real tasks performed
6767
by someone doing their work. If you can identify authentic tasks from your
@@ -105,7 +105,7 @@ If you are new to teaching, try to ask an experienced instructor for feedback be
105105
While we aim to begin workshops with motivating content, in practice this does not always occur. Workflow-based content like that taught in Data Carpentry
106106
workshops may start at the beginning of the workflow, for example. Even when a 'motivating example' is built in to the start of a workshop, technical
107107
problems like software installation can turn those precious first minutes into an experience of frustration and impatience. That is ok! What is important is to
108-
**be mindful of times when your content is not motivating**, and to strategize ways to re-engage learners (and yourself) using some of the other techniques in this section.
108+
**be mindful of times when your content is not motivating**, and to strategise ways to re-engage learners (and yourself) using some of the other techniques in this section.
109109

110110
## How Can You Affect Motivation?
111111

@@ -139,7 +139,7 @@ A few ways to invite participation are:
139139
- **Encouraging learners to learn from each other**. Working in pairs, or *[pair programming](https://en.wikipedia.org/wiki/Pair_programming)*, encourages
140140
learners to talk through their learning process, reinforcing memory and making it more likely that confusion will be expressed and
141141
resolved. This can also address challenges of varying background experience: asking more advanced learners to help beginners can
142-
maximize learning for both. In these cases, make sure the beginner is doing the typing!
142+
maximise learning for both. In these cases, make sure the beginner is doing the typing!
143143
- **Acknowledging when learners are confused**. Acknowledging and exploring confusion with kindness rewards learners for sharing vulnerable information. It also
144144
helps you examine your expert awareness gaps! Formative assessments can pinpoint misunderstandings. When learners see that others are confused, they are more likely to share their own uncertainties.
145145

@@ -229,12 +229,12 @@ This exercise should take about 5 minutes.
229229
::::::::::::::::::::::::::::::::::::::::::::::::::
230230

231231
- **Leveraging the power of "yet"**. A request for help might start with "I can't \_\_\_ " or "I don't understand \_\_\_ ". Depending on the attitude of the learner,
232-
these can sound like statements of fact rather than requests for help! Adding the word "yet" to the end of these sentences helps emphasize that being a novice is
232+
these can sound like statements of fact rather than requests for help! Adding the word "yet" to the end of these sentences helps emphasise that being a novice is
233233
a temporary state, and encourages a growth mindset towards progress.
234234

235235
### First, Do No Harm!
236236

237-
When learning a skill, we develop more than expert awareness gaps -- we also develop Opinions about tools and methods, and sometimes base a professional identity
237+
When learning a skill, we develop more than expert awareness gaps -- we also develop opinions about tools and methods, and sometimes base a professional identity
238238
around displaying technical expertise. Technical boasts, insults, and other showy moves can score points in conversation with fellow experts, but these present
239239
serious hazards in the classroom! Here are a few **things you should not do in your workshop:**
240240

@@ -265,7 +265,7 @@ serious hazards in the classroom! Here are a few **things you should not do in y
265265

266266
It can be difficult to avoid these demotivators entirely. Some people are so used to
267267
complaining about certain tools
268-
that they initially fail to realize they're doing it while teaching. If you catch yourself doing this, you might find a way to walk it back, or consider how you might repair or improve your motivational efforts on your next interaction. Teaching yourself -- and your helpers! --
268+
that they initially fail to realise they're doing it while teaching. If you catch yourself doing this, you might find a way to walk it back, or consider how you might repair or improve your motivational efforts on your next interaction. Teaching yourself -- and your helpers! --
269269
to avoid these types of comments takes practice, but is well worth the effort.
270270

271271
## Not Just Learners

0 commit comments

Comments
 (0)