diff --git a/aio.html b/aio.html index b5ac9e25b..714ac681c 100644 --- a/aio.html +++ b/aio.html @@ -1064,7 +1064,7 @@
Share your answers with your collaborators. How do they compare? If you have identified different audiences, are they compatible? Or would @@ -1085,7 +1085,7 @@
Take notes about your choice of target audience in your Lesson Design Notes document. It can be particularly helpful to note down any @@ -1106,7 +1106,7 @@
There is more to consider about your target audience than we could capture with only the questions listed above. In your own time, you @@ -1665,7 +1665,7 @@
Content from Example Data and Narrative
Last updated on 2024-09-09 | +
Last updated on 2024-11-29 | Edit this page
Use varied examples if you want to teach abstract @@ -1880,7 +1880,7 @@
Testimonial
-++If you’d like to read more about CC0 and CC-BY, Katie Fortney wrote an excellent blogpost @@ -1947,11 +1947,13 @@
Examples of Public Repositories
- Dryad
-- The Data -Curation Network’s datasets
+- The Open Science Framework
- The Offical Portal for European Data
+- Harvard Dataverse
- DataONE
+- The Data +Curation Network’s datasets
- The Official Portal for Argentina Data (in Spanish)
@@ -2002,6 +2004,43 @@Exercise: Choosing a Dataset or Narrative (30 minutes)
+++ ++++Where to Store your Example Data
+++GitHub is not a good place to store data, especially when it is large +and/or does not consist of text files. Instead, we recommend that you +publish your example data elsewhere and link to it from your lesson +website. This has the added advantages that you can publish the data +under its own license (ideally CC0, as discussed above), obtain a +separate DOI for it, and create another backup of your data. Dryad, Figshare, the Open Science Framework, and Zenodo are good general platforms for +publishing data. However, if your lesson covers a particular domain with +its own established standard for publishing data, we recommend that you +use that. The Generalist +Repositories Ecosystem Initiative (GREI) includes several more +general options, and provides a decision tree to help you +choose the most appropriate location for your data.
+When you publish the data for your lesson, make sure to include:
++
+- a description of each of the files included.
+- information about their provenance.
+- the lesson they are used in.
+- the license terms.
+- anything else you think people need to know about the data.
+See the +Figshare entry of data used in Data Carpentry Image Processing +workshops for an example.
+
People learn faster if they are motivated2, and learners will be motivated if you teach most useful things first. As you think about what story your lesson will tell, it is important to put the @@ -2029,7 +2068,6 @@
Useful further reading: Course design: Considerations for Trainers – a Professional Guide.
@@ -2457,7 +2495,7 @@Some examples of formative assessments used so far in this training:
@@ -2520,7 +2558,7 @@The Trainers will assign your group a type of exercise to focus on.
Read about your given exercise type in the
@@ -2598,7 +2636,7 @@ The Trainers will assign your group a type of exercise to focus on.
Read about your given exercise type on the indicated pages of Is
@@ -2645,7 +2683,7 @@ Both of the resources linked from the exercise above, the
Exercise Types chapter of Teaching Tech Together
@@ -2703,7 +2741,7 @@ Detecting and correcting misconceptions
and fixing learners’ incorrect/broken mental
@@ -2754,7 +2792,7 @@ The same approach to designing exercises within a lesson can also be
used to create a short “pre-assessment” questionnaire for potential
@@ -5834,7 +5872,7 @@ If you work on multiple projects, or the projects you follow on
GitHub are particularly active, the volume of notifications you receive
@@ -6140,7 +6178,7 @@ For a good description of differences between the two, have a look at
this
@@ -6308,7 +6346,7 @@ As a team read the
description of project governance for this training curriculum. The Dealing with Disruptive
Behaviours resource from the US National Oceanic and
diff --git a/audience.html b/audience.html
index 5cf1ee67c..302ece99b 100644
--- a/audience.html
+++ b/audience.html
@@ -584,7 +584,7 @@ Share your answers with your collaborators. How do they compare? If
you have identified different audiences, are they compatible? Or would
@@ -605,7 +605,7 @@ Take notes about your choice of target audience in your Lesson Design
Notes document. It can be particularly helpful to note down any
@@ -626,7 +626,7 @@ There is more to consider about your target audience than we could
capture with only the questions listed above. In your own time, you
diff --git a/collaborating-newcomers.html b/collaborating-newcomers.html
index 00d3fefdc..601805807 100644
--- a/collaborating-newcomers.html
+++ b/collaborating-newcomers.html
@@ -747,7 +747,7 @@ If you work on multiple projects, or the projects you follow on
GitHub are particularly active, the volume of notifications you receive
diff --git a/formative-assessment.html b/formative-assessment.html
index 13054ccab..87e3363b6 100644
--- a/formative-assessment.html
+++ b/formative-assessment.html
@@ -493,7 +493,7 @@ Useful further reading: Course design:
Considerations for Trainers – a Professional Guide. Some examples of formative assessments used so far in this
training: The Trainers will assign your group a type of exercise to focus on.
Read about your given exercise type in the
@@ -718,7 +718,7 @@ The Trainers will assign your group a type of exercise to focus on.
Read about your given exercise type on the indicated pages of Is
@@ -761,7 +761,7 @@ Both of the resources linked from the exercise above, the
Exercise Types chapter of Teaching Tech Together
@@ -819,7 +819,7 @@ Detecting and correcting misconceptions
and fixing learners’ incorrect/broken mental
@@ -870,7 +870,7 @@ The same approach to designing exercises within a lesson can also be
used to create a short “pre-assessment” questionnaire for potential
diff --git a/instructor/aio.html b/instructor/aio.html
index e32d195b8..d4bd8b71c 100644
--- a/instructor/aio.html
+++ b/instructor/aio.html
@@ -564,7 +564,7 @@ You might like to make a copy of the template
CodiMD notetaking page and share your link with trainees so that you
@@ -1108,7 +1108,7 @@ Share your answers with your collaborators. How do they compare? If
you have identified different audiences, are they compatible? Or would
@@ -1129,7 +1129,7 @@ Take notes about your choice of target audience in your Lesson Design
Notes document. It can be particularly helpful to note down any
@@ -1150,7 +1150,7 @@ There is more to consider about your target audience than we could
capture with only the questions listed above. In your own time, you
@@ -1737,7 +1737,7 @@ Content from Example Data and Narrative Last updated on 2024-09-09 |
+ Last updated on 2024-11-29 |
Edit this page Estimated time: 65 minutes Use varied examples if you want to teach abstract
@@ -1953,7 +1953,7 @@ If you’d like to read more about CC0 and CC-BY, Katie Fortney wrote
an excellent blogpost
@@ -2017,7 +2017,7 @@ Outline covering the above paragraph - also used in CodiMD
template. GitHub is not a good place to store data, especially when it is large
+and/or does not consist of text files. Instead, we recommend that you
+publish your example data elsewhere and link to it from your lesson
+website. This has the added advantages that you can publish the data
+under its own license (ideally CC0, as discussed above), obtain a
+separate DOI for it, and create another backup of your data. Dryad, Figshare, the Open Science Framework, and Zenodo are good general platforms for
+publishing data. However, if your lesson covers a particular domain with
+its own established standard for publishing data, we recommend that you
+use that. The Generalist
+Repositories Ecosystem Initiative (GREI) includes several more
+general options, and provides a decision tree to help you
+choose the most appropriate location for your data. When you publish the data for your lesson, make sure to include: See the
+Figshare entry of data used in Data Carpentry Image Processing
+workshops for an example. People learn faster if they are motivated2, and learners will be
motivated if you teach most useful things first. As you
think about what story your lesson will tell, it is important to put the
@@ -2135,7 +2174,6 @@ Useful further reading: Course design:
Considerations for Trainers – a Professional Guide. Some examples of formative assessments used so far in this
training: The Trainers will assign your group a type of exercise to focus on.
Read about your given exercise type in the
@@ -2706,7 +2744,7 @@ The Trainers will assign your group a type of exercise to focus on.
Read about your given exercise type on the indicated pages of Is
@@ -2753,7 +2791,7 @@ Both of the resources linked from the exercise above, the
Exercise Types chapter of Teaching Tech Together
@@ -2811,7 +2849,7 @@ Detecting and correcting misconceptions
and fixing learners’ incorrect/broken mental
@@ -2862,7 +2900,7 @@ The same approach to designing exercises within a lesson can also be
used to create a short “pre-assessment” questionnaire for potential
@@ -5146,7 +5184,7 @@ If trainees would like to add the Design Notes document they have
been working on to their lesson site, they can do the following: This episode picks-up after a long break in training for learners,
you may need to remind them of the following expectations as part of
@@ -5292,7 +5330,7 @@ For online trainings, Trainers have found it beneficial to give
participants the first 5 minutes together in a breakout room, to
@@ -5902,7 +5940,7 @@ It is helpful to share an example of a README when teaching this
section. Use your own example if you have one, or otherwise share the
@@ -6168,7 +6206,7 @@ The next spoiler contains a lot of information, and can require a lot
of time to discuss fully while training. We recommend that you do not
@@ -6188,7 +6226,7 @@ If you work on multiple projects, or the projects you follow on
GitHub are particularly active, the volume of notifications you receive
@@ -6495,7 +6533,7 @@ For a good description of differences between the two, have a look at
this
@@ -6663,7 +6701,7 @@ As a team read the
description of project governance for this training curriculum. The Dealing with Disruptive
Behaviours resource from the US National Oceanic and
diff --git a/instructor/audience.html b/instructor/audience.html
index 24bd5a067..1ce057356 100644
--- a/instructor/audience.html
+++ b/instructor/audience.html
@@ -586,7 +586,7 @@ Share your answers with your collaborators. How do they compare? If
you have identified different audiences, are they compatible? Or would
@@ -607,7 +607,7 @@ Take notes about your choice of target audience in your Lesson Design
Notes document. It can be particularly helpful to note down any
@@ -628,7 +628,7 @@ There is more to consider about your target audience than we could
capture with only the questions listed above. In your own time, you
diff --git a/instructor/collaborating-newcomers.html b/instructor/collaborating-newcomers.html
index d659043ff..74073eba8 100644
--- a/instructor/collaborating-newcomers.html
+++ b/instructor/collaborating-newcomers.html
@@ -525,7 +525,7 @@ It is helpful to share an example of a README when teaching this
section. Use your own example if you have one, or otherwise share the
@@ -768,7 +768,7 @@ The next spoiler contains a lot of information, and can require a lot
of time to discuss fully while training. We recommend that you do not
@@ -788,7 +788,7 @@ If you work on multiple projects, or the projects you follow on
GitHub are particularly active, the volume of notifications you receive
diff --git a/instructor/formative-assessment.html b/instructor/formative-assessment.html
index 07be7a9ab..77a22d6c2 100644
--- a/instructor/formative-assessment.html
+++ b/instructor/formative-assessment.html
@@ -495,7 +495,7 @@ Useful further reading: Course design:
Considerations for Trainers – a Professional Guide. Some examples of formative assessments used so far in this
training: The Trainers will assign your group a type of exercise to focus on.
Read about your given exercise type in the
@@ -720,7 +720,7 @@ The Trainers will assign your group a type of exercise to focus on.
Read about your given exercise type on the indicated pages of Is
@@ -763,7 +763,7 @@ Both of the resources linked from the exercise above, the
Exercise Types chapter of Teaching Tech Together
@@ -821,7 +821,7 @@ Detecting and correcting misconceptions
and fixing learners’ incorrect/broken mental
@@ -872,7 +872,7 @@ The same approach to designing exercises within a lesson can also be
used to create a short “pre-assessment” questionnaire for potential
diff --git a/instructor/introduction.html b/instructor/introduction.html
index 2be4b2032..2340a8348 100644
--- a/instructor/introduction.html
+++ b/instructor/introduction.html
@@ -481,7 +481,7 @@ For lessons predominantly teachi
-
Exercise: Exercise Types and When to Use Them
-
An Expert’s View on Objectives and Audience Expertis
-
Exercise: Assessing Progress Towards an Objective (30
-
Managing GitHub Notifications
-
Milestones vs Projects
-
For Teams of Collaborators
-
For Lesson Developers Working Alone
-
Part 2a (for groups collaborating on the same lesson, 10 minutes)
-
Part 2b (for participants developing their lesson alone, 10 minutes)
-
Thinking more about target audience
-
Managing GitHub Notifications
-Objectives
-Formative Assessments in this Training (5 mins)
- Show me the solution
-Exercise: Exercise Types and When to Use Them (15 minu
-
For lessons predominantly teachi
-
Exercise: Exercise Types and When to Use Them
-
An Expert’s View on Objectives and Audience Expertis
-
Exercise: Assessing Progress Towards an Objective (30
-
Objectives
-
Part 2a (for groups collaborating on the same lesson, 10 minutes)
-
Part 2b (for participants developing their lesson alone, 10 minutes)
-
Thinking more about target audience
-Key Points
-Objectives
-
Testimonial
-
-Examples of Public Repositories
Exercise: Choosing a Dataset or Narrative (30 minutes)
Where to Store your Example Data
+
+
+Constructing Narrative to Motivate Learners
+
+
Testimonial
Summary
@@ -2459,7 +2497,7 @@ Objectives
-Formative Assessments in this Training (5 mins)
- Show me the solution
-
Exercise: Exercise Types and When to Use Them (15 minu
-
For lessons predominantly teachi
-
Exercise: Exercise Types and When to Use Them
-
An Expert’s View on Objectives and Audience Expertis
-
Exercise: Assessing Progress Towards an Objective (30
-
Adding Design Notes to the Lesson Site
-Objectives
-Exercise: Check in (10 minutes)
-
Share an example of a good README
-
Time management tip: share the next spoiler, do not teach it
-
Managing GitHub Notifications
-
Milestones vs Projects
-
For Teams of Collaborators
-
For Lesson Developers Working Alone
-
Part 2a (for groups collaborating on the same lesson, 10 minutes)
-
Part 2b (for participants developing their lesson alone, 10 minutes)
-
Thinking more about target audience
-
Share an example of a good README
-
Time management tip: share the next spoiler, do not teach it
-
Managing GitHub Notifications
-Objectives
-Formative Assessments in this Training (5 mins)
- Show me the solution
-Exercise: Exercise Types and When to Use Them (15 minu
-
For lessons predominantly teachi
-
Exercise: Exercise Types and When to Use Them
-
An Expert’s View on Objectives and Audience Expertis
-
Exercise: Assessing Progress Towards an Objective (30
-
Objectives