- Creating a New Course
- Creating a New Lesson in an Existing Course
- Resuming Work on a Lesson in an Existing Course
- Checking Which Lesson You're Working On
- Adding Questions to a Lesson
- Types of Questions
- Managing the Course Manifest
- Writing Custom Tests
- Including Data in a Lesson
- Converting Materials from Other Formats Into a swirl Lesson
- Using Special Characters in Lessons
Clone this wiki locally
This documentation is deprecated. For the latest version of the swirlify documentation please visit: http://swirlstats.com/swirlify
Welcome to the swirlify documentation. The swirlify package is designed to help users write and edit swirl courses.
A swirl course is a directory that contains all of the files, folders, and lessons associated with the course you are developing. Lessons contain most of the content that students interact with, and the course sequentially organizes theses lessons. A course should conceptually encapsulate a single concept that you want to teach.
A lesson is a directory that contains all of the files required to execute one
unit of instruction inside of swirl. Every lesson must contain one
file which structures the text that the student will see inside the R console
while they are using swirl. The
lesson.yaml file contains a sequence of
questions and the primary utility of swirlify is to help course authors when
writing these questions.
Courses have the following general structure:
Course_Name ├─ Lesson_1 | └─ lesson.yaml ├─ Lesson_2 | └─ lesson.yaml └─ MANIFEST
MANIFEST file contains the order in which lessons will be displayed.
We highly recommend using RStudio for writing swirl courses and using swirlify. The swirlify package is intended to be used with an R console and a text editor simultaneously open. In this way, RStudio provides the perfect environment.
Click here to start learning how to create your own swirl courses.