diff --git a/README.md b/README.md index 967aeb8..ff50e55 100644 --- a/README.md +++ b/README.md @@ -11,28 +11,29 @@ local scripts. The tool is a Flask application that Canvas launches over LTI 1.3. A single URL serves everyone: Canvas identifies the person and course on -each launch, so instructors get the call-list and reporting views while -students get the absence form and their own history. The roster comes -from Canvas through the Names and Role Provisioning Service, which means -adds and drops are picked up automatically rather than reconciled by -hand. +each launch, so instructors get the call-list and reporting views +while students get the absence form and their own history. The roster +comes from Canvas through the Names and Role Provisioning Service, +which means adds and drops are picked up automatically rather than +reconciled by hand. -Selection uses the same weighting as the manual system it replaces: each -answered call divides a student's weight by the course's weight factor -(default 2), so students who have answered more questions become -progressively less likely to be called. Each course can instead use -"cycle" mode, a rolling rotation through the roster in random order: -everyone is called once before anyone repeats, batches take the next -students in the current pass (continuing across lists and class days), -and skipped calls don't count as a turn. These, along with whether -students can see their own assessments, are per-course settings. +Selection uses the same weighting as the manual system it replaces: +each answered call divides a student's weight by the course's weight +factor (default 2), so students who have answered more questions +become progressively less likely to be called. Each course can instead +use "cycle" mode, a rolling rotation through the roster in random +order: everyone is called once before anyone repeats, batches take the +next students in the current pass (continuing across lists and class +days), and skipped calls don't count as a turn. These, along with +whether students can see their own assessments, are per-course +settings. ## Daily use The instructor page works against a selectable date (defaulting to today), so printing tomorrow's list a day in advance just means -switching the working date. There are two ways to run a class, per -day and freely mixed: +switching the working date. There are two ways to run a class, per day +and freely mixed: - **Live mode**: a "call next student" button shows who's up (photo, name, pronouns) with one-tap outcomes — the assessment levels,