Sample episode in ReST¶
Questions
How does a typical lesson page look?
Questions list questions to get the interest of learners
point 2
…
Objectives
Show a complete lesson page with all of the most common structures.
Objectives list what you get out of the page (not just what you do)
point 2
…
Topic introduction here
You really want to browse this page alongside the source of it, to see how this is implemented. See the links at the to right of the page.
This is a section¶
This is text.
A code block with preceeding paragraph:
import multiprocessing
A bullet list
Bullet list
Sub-list:
code block (note indention)
Note
directive within a list (note indention)
import bisect
a = 1 + 2
library(x)
a <- 1 + 2
Exercise: the general topic¶
Exercises get their own section, so that they can be linked and found in the table of contents.
1.1 Exercise title
Notice the exercise set has both an ID and number
SampleLesson-1and description of what it contains.
Solution
Solution here.
1.2 Create a lesson
Similarly, each exercise has a quick description title
Create a lessonin bold. These titles are useful so that helpers (and learners…) can quickly understand what the point is.
Solution
Solution to that one.
Another section¶
Instructor note
This is an instructor note. It may be hidden or put to the sidebar in a later style. You should use it for things that the instructor should see while teaching, but should be de-emphasized for the learners.
These tab synchronize with those above:
import cmath
a = 10 / 2
library(x)
a <- 10 / 2
