Curriculum Development Handbook
Preface
1
Guiding principles
1.1
Backward design
1.1.1
Identifying the practical skills
1.1.2
Designing challenges to assess understanding
1.1.3
Planning the content of the lesson
1.2
Creating a narrative and selecting a dataset
1.3
Limitations of our approach
2
Our curriculum structure
2.1
Episodes
2.2
Lessons
2.3
Curricula
2.4
Lesson Collections
3
Deciding what to teach
3.1
Target audience
3.1.1
Audience definition questions
3.1.2
Learner profiles
3.2
Skills list
3.3
Example using a Software Carpentry Learner Profile
4
Designing challenges
4.1
Picking a dataset
4.2
Formatting the dataset for teaching
4.3
Designing challenges
4.4
Different types of challenges
4.4.1
Multiple Choice Questions
4.4.2
Parson’s problems
4.4.3
Fill-in-the-blank problems
4.4.4
Use the concept in a different context
5
Developing content
5.1
Fundamental elements
5.1.1
Code chunks
5.1.2
Narrative text
5.1.3
Considering cognitive load
5.2
Supporting elements
5.2.1
Learning objectives
5.2.2
Key points
5.2.3
Framing questions
6
Community development roles
6.1
Lesson Authors
6.2
Reviewers
6.3
Lesson Maintainers
6.3.1
Maintainer recruitment, requirements and time commitment
6.4
Curriculum Advisors
6.5
Beta Pilot Instructors
6.6
Instructors
6.7
Summary
7
The lesson life-cycle
7.1
Scope of this chapter
7.2
Overview and definitions
7.3
Where to start
7.3.1
Official Track
7.3.2
Community Track
7.3.3
Carpentries Lab Track
7.4
Early development (pre-alpha through alpha)
7.5
Field testing: alpha stage
7.6
Polishing: beta stage
7.7
Stable stage
7.7.1
Official Track
7.7.2
Community/Carpentries Lab track
7.8
The stable lesson: Maintenance and lesson releases
8
Technological introductions
8.1
Lesson hosting and rendering
8.2
Using the lesson template
8.2.1
Creating your lesson repository
8.2.2
Lesson homepage
8.2.3
Episode files
8.2.4
Extras
8.2.5
Other information
8.2.6
Special notes on RMarkdown
8.3
Working on GitHub
Appendix
A
The Carpentries Incubator
A.1
Lesson Proposals
A.2
Topic Tags
A.3
Using GitHub Issue Labels
A.3.1
Using Labels to Encourage Contributions
B
Bibliography
C
Adapting Existing Lessons for The Carpentries
C.1
Lesson Template
C.2
Conversion from Jupyter
C.3
Conversion from RMarkdown
C.4
Conversion from other formats
C.5
Markdown
C.5.1
Set up a lesson repository
C.5.2
Add YAML Front Matter
C.5.3
Add
alt
Text to Images
C.5.4
Add to
_episodes
C.5.5
Organise supporting files
C.5.6
Implement formatted blocks
C.5.7
(Recommended) Centralise Link References
C.5.8
Complete Lesson Repository Setup
D
Lesson Sprint Recommendations
D.1
Introduction
D.1.1
Target Audience
D.1.2
Objectives
D.2
Before the Sprint
D.2.1
Before The Sprint: Recommendations for GitHub
D.3
During the Sprint
D.3.1
During the Sprint: Recommendations for GitHub
D.4
After the Sprint
D.4.1
After the Sprint: Recommendations for GitHub
D.5
Tools and Resources
D.6
Acknowledgments
D.7
Further Reading
Cite this handbook
Licensed under CC-BY 4.0
Published with bookdown
The Carpentries Curriculum Development Handbook
B
Bibliography