chore: UK -> US
This commit is contained in:
21 files changed
+51
-51
No files matched your search
@@ -52,7 +52,7 @@ The design rests on a few commitments.
|
|||||||
- A fingerprint covers only what a student saw: the fingerprint of an item is computed from its stem, its options (with which are correct), and its stimulus. Tags, topics, and other metadata do not contribute. Retagging an item keeps its pooled statistics valid, while rewording the stem changes the fingerprint and marks the statistics stale.
|
- A fingerprint covers only what a student saw: the fingerprint of an item is computed from its stem, its options (with which are correct), and its stimulus. Tags, topics, and other metadata do not contribute. Retagging an item keeps its pooled statistics valid, while rewording the stem changes the fingerprint and marks the statistics stale.
|
||||||
- Validation reports everything at once: `validate` collects every problem and prints them together, so you fix a file in one pass instead of one error at a time.
|
- Validation reports everything at once: `validate` collects every problem and prints them together, so you fix a file in one pass instead of one error at a time.
|
||||||
- Validation and linting are separate: `validate` finds problems that must be fixed. `lint` finds weaknesses in item craft, and every lint rule has a code that you can silence.
|
- Validation and linting are separate: `validate` finds problems that must be fixed. `lint` finds weaknesses in item craft, and every lint rule has a code that you can silence.
|
||||||
- Small samples are labelled: an analysis of fewer than 100 examinees says so, and states the standard error it uses.
|
- Small samples are labeled: an analysis of fewer than 100 examinees says so, and states the standard error it uses.
|
||||||
- No database and no hidden state: a course is a directory in a git repository. The tool holds no state of its own, so a course set up in 2026 opens in 2031 with whatever version of coursebank you have then.
|
- No database and no hidden state: a course is a directory in a git repository. The tool holds no state of its own, so a course set up in 2026 opens in 2031 with whatever version of coursebank you have then.
|
||||||
|
|
||||||
## The files
|
## The files
|
||||||
@@ -607,7 +607,7 @@ A form given twice, or a form the record does not declare, is an error.
|
|||||||
Gradescope numbers questions by printed position, and the decoder maps each printed position to the recorded question number and each printed letter to the option it was, using the seal.
|
Gradescope numbers questions by printed position, and the decoder maps each printed position to the recorded question number and each printed letter to the option it was, using the seal.
|
||||||
The decoded rows keep the printed letters in `selected` and `eliminated` and add the bank-lettering in `selected_source` and `eliminated_source`.
|
The decoded rows keep the printed letters in `selected` and `eliminated` and add the bank-lettering in `selected_source` and `eliminated_source`.
|
||||||
|
|
||||||
Three checks guard against a mislabelled directory or a bad key.
|
Three checks guard against a mislabeled directory or a bad key.
|
||||||
The first compares each directory's graded key with every declared form's printed key, so that swapped directories are detected; a mismatch blocks the ingest unless you pass `--allow-mismatch`, which turns it into a warning.
|
The first compares each directory's graded key with every declared form's printed key, so that swapped directories are detected; a mismatch blocks the ingest unless you pass `--allow-mismatch`, which turns it into a warning.
|
||||||
The second flags a student who appears on more than one form, and a form that is missing a question the record expects.
|
The second flags a student who appears on more than one form, and a form that is missing a question the record expects.
|
||||||
The third warns when two forms differ in mean score by 5 percentage points or more with at least 5 students on each.
|
The third warns when two forms differ in mean score by 5 percentage points or more with at least 5 students on each.
|
||||||
|
|||||||
+1
-1
@@ -79,7 +79,7 @@ Keys *under* `extra` are yours and reach Typst verbatim, so they conventionally
|
|||||||
### `extra` is the escape hatch
|
### `extra` is the escape hatch
|
||||||
|
|
||||||
Anything under `extra` is carried through untouched and arrives as `extra` in the payload.
|
Anything under `extra` is carried through untouched and arrives as `extra` in the payload.
|
||||||
Tier colours, a font stack, a `show-solutions` flag, a watermark, column counts.
|
Tier colors, a font stack, a `show-solutions` flag, a watermark, column counts.
|
||||||
Put it there and read it in the template.
|
Put it there and read it in the template.
|
||||||
Nothing about appearance needs to be added to this crate.
|
Nothing about appearance needs to be added to this crate.
|
||||||
|
|
||||||
|
|||||||
@@ -55,7 +55,7 @@ equations:
|
|||||||
- { symbol: 'd', term: term-gap-penalty }
|
- { symbol: 'd', term: term-gap-penalty }
|
||||||
implications:
|
implications:
|
||||||
- { form: direction, statement: 'Raising {term-gap-penalty} makes the diagonal win more cells.' }
|
- { form: direction, statement: 'Raising {term-gap-penalty} makes the diagonal win more cells.' }
|
||||||
assumes: ['Each gap position costs the same, whatever its neighbours.']
|
assumes: ['Each gap position costs the same, whatever its neighbors.']
|
||||||
fails_when: ['Gaps come in long runs, which a linear penalty charges too much for.']
|
fails_when: ['Gaps come in long runs, which a linear penalty charges too much for.']
|
||||||
recall: true
|
recall: true
|
||||||
|
|
||||||
|
|||||||
@@ -191,7 +191,7 @@ pub struct Prediction {
|
|||||||
/// The discrimination band the author expected, as `(low, high)`.
|
/// The discrimination band the author expected, as `(low, high)`.
|
||||||
pub expected_band: Option<(f64, f64)>,
|
pub expected_band: Option<(f64, f64)>,
|
||||||
/// Whether the expectation rests on a calibration with enough examinees
|
/// Whether the expectation rests on a calibration with enough examinees
|
||||||
/// behind it, rather than on the author's judgement alone.
|
/// behind it, rather than on the author's judgment alone.
|
||||||
pub calibrated: bool,
|
pub calibrated: bool,
|
||||||
/// Signed difficulty error, observed minus expected. Positive means the item
|
/// Signed difficulty error, observed minus expected. Positive means the item
|
||||||
/// was easier than predicted.
|
/// was easier than predicted.
|
||||||
|
|||||||
@@ -106,7 +106,7 @@ pub struct Options {
|
|||||||
/// Whether to include the worked solution for a missed question.
|
/// Whether to include the worked solution for a missed question.
|
||||||
///
|
///
|
||||||
/// Off by default. [`crate::item::Solution::explanation`] is the derivation,
|
/// Off by default. [`crate::item::Solution::explanation`] is the derivation,
|
||||||
/// the estimate, and the argument for the key over its neighbours: the body of
|
/// the estimate, and the argument for the key over its neighbors: the body of
|
||||||
/// the solutions document. Turning this on hands that to every student who
|
/// the solutions document. Turning this on hands that to every student who
|
||||||
/// missed the question, which is the right call for a question you will not
|
/// missed the question, which is the right call for a question you will not
|
||||||
/// use again and the wrong one for a bank you reuse each term.
|
/// use again and the wrong one for a bank you reuse each term.
|
||||||
@@ -342,7 +342,7 @@ pub struct Measured {
|
|||||||
/// The target the question was written against.
|
/// The target the question was written against.
|
||||||
pub target: String,
|
pub target: String,
|
||||||
/// The target's explanation, with references rendered as words: what
|
/// The target's explanation, with references rendered as words: what
|
||||||
/// meeting it looks like, which is what to practise towards.
|
/// meeting it looks like, which is what to practice toward.
|
||||||
#[serde(skip_serializing_if = "Option::is_none")]
|
#[serde(skip_serializing_if = "Option::is_none")]
|
||||||
pub explanation: Option<String>,
|
pub explanation: Option<String>,
|
||||||
}
|
}
|
||||||
@@ -396,7 +396,7 @@ pub struct QuestionRow {
|
|||||||
///
|
///
|
||||||
/// Both, because each answers a different question a student has in front of
|
/// Both, because each answers a different question a student has in front of
|
||||||
/// a missed item. The target says what this question actually asked of them,
|
/// a missed item. The target says what this question actually asked of them,
|
||||||
/// which is the specific thing to go and practise. The objective says which
|
/// which is the specific thing to go and practice. The objective says which
|
||||||
/// row of the table above the mark landed in, which is how they tell whether
|
/// row of the table above the mark landed in, which is how they tell whether
|
||||||
/// one slip cost them a claim or whether it was one of several. Printing the
|
/// one slip cost them a claim or whether it was one of several. Printing the
|
||||||
/// target alone left them unable to connect the note to the table; printing
|
/// target alone left them unable to connect the note to the table; printing
|
||||||
@@ -466,7 +466,7 @@ pub struct DroppedQuestion {
|
|||||||
pub struct ItemReading {
|
pub struct ItemReading {
|
||||||
/// A short citation, e.g. `KKW §2.1`.
|
/// A short citation, e.g. `KKW §2.1`.
|
||||||
pub citation: String,
|
pub citation: String,
|
||||||
/// The work's full title, for a student who does not recognise the label.
|
/// The work's full title, for a student who does not recognize the label.
|
||||||
#[serde(skip_serializing_if = "Option::is_none")]
|
#[serde(skip_serializing_if = "Option::is_none")]
|
||||||
pub title: Option<String>,
|
pub title: Option<String>,
|
||||||
/// A link, when the citation resolves to one.
|
/// A link, when the citation resolves to one.
|
||||||
@@ -1424,7 +1424,7 @@ pub struct GradeRow {
|
|||||||
/// The attainment word, when the scale records one.
|
/// The attainment word, when the scale records one.
|
||||||
#[serde(skip_serializing_if = "Option::is_none")]
|
#[serde(skip_serializing_if = "Option::is_none")]
|
||||||
pub attainment: Option<String>,
|
pub attainment: Option<String>,
|
||||||
/// The colour group, so A, A- and A+ can be tinted together.
|
/// The color group, so A, A- and A+ can be tinted together.
|
||||||
pub group: String,
|
pub group: String,
|
||||||
/// How many students landed in the band.
|
/// How many students landed in the band.
|
||||||
pub count: usize,
|
pub count: usize,
|
||||||
|
|||||||
+1
-1
@@ -16,7 +16,7 @@
|
|||||||
//! [`select`] draws an assessment from a blueprint. It places objective minimums
|
//! [`select`] draws an assessment from a blueprint. It places objective minimums
|
||||||
//! before level quotas, because a coverage requirement is the constraint most
|
//! before level quotas, because a coverage requirement is the constraint most
|
||||||
//! likely to become unsatisfiable, and it prefers least-recently-used items so a
|
//! likely to become unsatisfiable, and it prefers least-recently-used items so a
|
||||||
//! bank rotates rather than converging on your favourites.
|
//! bank rotates rather than converging on your favorites.
|
||||||
//!
|
//!
|
||||||
//! [`jsonschema`] emits JSON Schema so an editor autocompletes the YAML. That is
|
//! [`jsonschema`] emits JSON Schema so an editor autocompletes the YAML. That is
|
||||||
//! a better authoring experience than any validator: catching `cognitve_process`
|
//! a better authoring experience than any validator: catching `cognitve_process`
|
||||||
|
|||||||
@@ -522,7 +522,7 @@ fn value_schema() -> Value {
|
|||||||
"recall": {
|
"recall": {
|
||||||
"type": "boolean",
|
"type": "boolean",
|
||||||
"description": "Students are expected to know it. An exam never prints it, and \
|
"description": "Students are expected to know it. An exam never prints it, and \
|
||||||
no option or neighbouring item may give it away."
|
no option or neighboring item may give it away."
|
||||||
},
|
},
|
||||||
"status": entry_status(),
|
"status": entry_status(),
|
||||||
"tags": string_array("Free-form tags."),
|
"tags": string_array("Free-form tags."),
|
||||||
@@ -885,7 +885,7 @@ fn policy_base_schema() -> Value {
|
|||||||
},
|
},
|
||||||
"group": {
|
"group": {
|
||||||
"type": "string",
|
"type": "string",
|
||||||
"description": "Colour group for reports; defaults to the letter's \
|
"description": "Color group for reports; defaults to the letter's \
|
||||||
first character."
|
first character."
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1704,7 +1704,7 @@ fn variant_calibration_schema() -> Value {
|
|||||||
"discrimination_index": { "type": "number", "minimum": -1.0, "maximum": 1.0 },
|
"discrimination_index": { "type": "number", "minimum": -1.0, "maximum": 1.0 },
|
||||||
"option_stats": {
|
"option_stats": {
|
||||||
"type": "object",
|
"type": "object",
|
||||||
"description": "Per-option behaviour within this set, by option id.",
|
"description": "Per-option behavior within this set, by option id.",
|
||||||
"additionalProperties": option_stat_schema()
|
"additionalProperties": option_stat_schema()
|
||||||
},
|
},
|
||||||
"irt": irt_schema(),
|
"irt": irt_schema(),
|
||||||
|
|||||||
+5
-5
@@ -321,7 +321,7 @@ pub(crate) enum LectureCommand {
|
|||||||
Readings {
|
Readings {
|
||||||
/// Lecture id, e.g. L1.1.
|
/// Lecture id, e.g. L1.1.
|
||||||
id: String,
|
id: String,
|
||||||
/// Which flavour of Markdown to write.
|
/// Which flavor of Markdown to write.
|
||||||
#[arg(long, value_enum, default_value = "quarto")]
|
#[arg(long, value_enum, default_value = "quarto")]
|
||||||
style: StyleArg,
|
style: StyleArg,
|
||||||
/// Output path; prints to stdout when omitted.
|
/// Output path; prints to stdout when omitted.
|
||||||
@@ -339,7 +339,7 @@ pub(crate) enum LectureCommand {
|
|||||||
Objectives {
|
Objectives {
|
||||||
/// Lecture id, e.g. L1.1.
|
/// Lecture id, e.g. L1.1.
|
||||||
id: String,
|
id: String,
|
||||||
/// Which flavour of Markdown to write.
|
/// Which flavor of Markdown to write.
|
||||||
#[arg(long, value_enum, default_value = "quarto")]
|
#[arg(long, value_enum, default_value = "quarto")]
|
||||||
style: StyleArg,
|
style: StyleArg,
|
||||||
/// Output path; prints to stdout when omitted.
|
/// Output path; prints to stdout when omitted.
|
||||||
@@ -356,7 +356,7 @@ pub(crate) enum LectureCommand {
|
|||||||
Page {
|
Page {
|
||||||
/// Lecture id, e.g. L1.1.
|
/// Lecture id, e.g. L1.1.
|
||||||
id: String,
|
id: String,
|
||||||
/// Which flavour of Markdown to write.
|
/// Which flavor of Markdown to write.
|
||||||
#[arg(long, value_enum, default_value = "quarto")]
|
#[arg(long, value_enum, default_value = "quarto")]
|
||||||
style: StyleArg,
|
style: StyleArg,
|
||||||
/// Where the course glossary page lives, for links to entries this page
|
/// Where the course glossary page lives, for links to entries this page
|
||||||
@@ -370,7 +370,7 @@ pub(crate) enum LectureCommand {
|
|||||||
/// Write the course glossary page: every term, equation, and value, with
|
/// Write the course glossary page: every term, equation, and value, with
|
||||||
/// the lecture that introduces it.
|
/// the lecture that introduces it.
|
||||||
Glossary {
|
Glossary {
|
||||||
/// Which flavour of Markdown to write.
|
/// Which flavor of Markdown to write.
|
||||||
#[arg(long, value_enum, default_value = "quarto")]
|
#[arg(long, value_enum, default_value = "quarto")]
|
||||||
style: StyleArg,
|
style: StyleArg,
|
||||||
/// Output path; prints to stdout when omitted.
|
/// Output path; prints to stdout when omitted.
|
||||||
@@ -782,7 +782,7 @@ pub(crate) enum IngestCommand {
|
|||||||
#[command(flatten)]
|
#[command(flatten)]
|
||||||
common: IngestCommon,
|
common: IngestCommon,
|
||||||
/// Ingest even when a directory's graded keys do not match the form it
|
/// Ingest even when a directory's graded keys do not match the form it
|
||||||
/// was labelled with.
|
/// was labeled with.
|
||||||
#[arg(long)]
|
#[arg(long)]
|
||||||
allow_mismatch: bool,
|
allow_mismatch: bool,
|
||||||
/// The export numbers questions by recorded number rather than by
|
/// The export numbers questions by recorded number rather than by
|
||||||
|
|||||||
+1
-1
@@ -526,7 +526,7 @@ mod tests {
|
|||||||
use super::*;
|
use super::*;
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn a_labelled_source_parses() {
|
fn a_labeled_source_parses() {
|
||||||
let source = Source::parse("B=exports/e1-b", None).unwrap();
|
let source = Source::parse("B=exports/e1-b", None).unwrap();
|
||||||
assert_eq!(source.form, "B");
|
assert_eq!(source.form, "B");
|
||||||
assert_eq!(source.dir, PathBuf::from("exports/e1-b"));
|
assert_eq!(source.dir, PathBuf::from("exports/e1-b"));
|
||||||
|
|||||||
+10
-10
@@ -26,7 +26,7 @@
|
|||||||
//! Since 2.1 a lecture is more than its objectives and readings, and
|
//! Since 2.1 a lecture is more than its objectives and readings, and
|
||||||
//! [`page_markdown`] renders all of it, in the order the specification gives:
|
//! [`page_markdown`] renders all of it, in the order the specification gives:
|
||||||
//! the lecture's description; each objective with its description and its
|
//! the lecture's description; each objective with its description and its
|
||||||
//! targets (by ceiling, each labelled with the course's own level name and
|
//! targets (by ceiling, each labeled with the course's own level name and
|
||||||
//! followed by its explanation); the terms new in this lecture, then the ones
|
//! followed by its explanation); the terms new in this lecture, then the ones
|
||||||
//! from earlier lectures; the equations its targets turn on; the numbers to
|
//! from earlier lectures; the equations its targets turn on; the numbers to
|
||||||
//! know; the common mistakes; the readings, with minutes; and the materials.
|
//! know; the common mistakes; the readings, with minutes; and the materials.
|
||||||
@@ -44,7 +44,7 @@ use crate::course::{CourseFile, Reading, ReadingRole, Reference};
|
|||||||
use crate::error::{Error, Result};
|
use crate::error::{Error, Result};
|
||||||
use crate::taxonomy::Level;
|
use crate::taxonomy::Level;
|
||||||
|
|
||||||
/// Which flavour of Markdown to emit.
|
/// Which flavor of Markdown to emit.
|
||||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
|
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
|
||||||
pub enum Style {
|
pub enum Style {
|
||||||
/// Pandoc definition lists with `<br>` before the objective line, which is
|
/// Pandoc definition lists with `<br>` before the objective line, which is
|
||||||
@@ -288,7 +288,7 @@ fn by_level<'a>(course: &CourseFile, ids: &[&'a str]) -> Vec<(Option<Level>, Vec
|
|||||||
///
|
///
|
||||||
/// * `course` - the loaded course file.
|
/// * `course` - the loaded course file.
|
||||||
/// * `lecture` - the lecture id.
|
/// * `lecture` - the lecture id.
|
||||||
/// * `style` - which flavour to emit.
|
/// * `style` - which flavor to emit.
|
||||||
///
|
///
|
||||||
/// # Returns
|
/// # Returns
|
||||||
///
|
///
|
||||||
@@ -342,7 +342,7 @@ pub fn objectives_markdown(course: &CourseFile, lecture: &str, style: Style) ->
|
|||||||
/// # Arguments
|
/// # Arguments
|
||||||
///
|
///
|
||||||
/// * `text` - the objective or target text.
|
/// * `text` - the objective or target text.
|
||||||
/// * `style` - which flavour to emit.
|
/// * `style` - which flavor to emit.
|
||||||
///
|
///
|
||||||
/// # Returns
|
/// # Returns
|
||||||
///
|
///
|
||||||
@@ -360,7 +360,7 @@ fn bullet(text: &str, style: Style) -> String {
|
|||||||
///
|
///
|
||||||
/// * `course` - the loaded course file.
|
/// * `course` - the loaded course file.
|
||||||
/// * `lecture` - the lecture id, such as `L1.1`.
|
/// * `lecture` - the lecture id, such as `L1.1`.
|
||||||
/// * `style` - which flavour to emit.
|
/// * `style` - which flavor to emit.
|
||||||
///
|
///
|
||||||
/// # Returns
|
/// # Returns
|
||||||
///
|
///
|
||||||
@@ -401,7 +401,7 @@ pub fn readings_markdown(course: &CourseFile, lecture: &str, style: Style) -> Re
|
|||||||
///
|
///
|
||||||
/// * `course` - the course, for resolving references and placeholders.
|
/// * `course` - the course, for resolving references and placeholders.
|
||||||
/// * `reading` - the reading.
|
/// * `reading` - the reading.
|
||||||
/// * `style` - which flavour to emit.
|
/// * `style` - which flavor to emit.
|
||||||
/// * `number` - the position of an objective on this page, if it has one.
|
/// * `number` - the position of an objective on this page, if it has one.
|
||||||
///
|
///
|
||||||
/// # Returns
|
/// # Returns
|
||||||
@@ -481,7 +481,7 @@ fn entry(
|
|||||||
/// * `reading` - the reading.
|
/// * `reading` - the reading.
|
||||||
/// * `key` - its citation key.
|
/// * `key` - its citation key.
|
||||||
/// * `reference` - the cited work.
|
/// * `reference` - the cited work.
|
||||||
/// * `style` - which flavour to emit.
|
/// * `style` - which flavor to emit.
|
||||||
///
|
///
|
||||||
/// # Returns
|
/// # Returns
|
||||||
///
|
///
|
||||||
@@ -509,7 +509,7 @@ pub const DEFAULT_GLOSSARY_HREF: &str = "glossary.html";
|
|||||||
/// How to render a lecture page or the glossary page.
|
/// How to render a lecture page or the glossary page.
|
||||||
#[derive(Debug, Clone)]
|
#[derive(Debug, Clone)]
|
||||||
pub struct PageOptions {
|
pub struct PageOptions {
|
||||||
/// Which flavour of Markdown to emit. Quarto gives each glossary entry an
|
/// Which flavor of Markdown to emit. Quarto gives each glossary entry an
|
||||||
/// anchor and links to it on the same page when it is there; Plain links
|
/// anchor and links to it on the same page when it is there; Plain links
|
||||||
/// every entry to the glossary page.
|
/// every entry to the glossary page.
|
||||||
pub style: Style,
|
pub style: Style,
|
||||||
@@ -675,7 +675,7 @@ impl Needs {
|
|||||||
///
|
///
|
||||||
/// * `course` - the loaded course file.
|
/// * `course` - the loaded course file.
|
||||||
/// * `lecture` - the lecture id.
|
/// * `lecture` - the lecture id.
|
||||||
/// * `options` - the Markdown flavour and the glossary page's address.
|
/// * `options` - the Markdown flavor and the glossary page's address.
|
||||||
///
|
///
|
||||||
/// # Returns
|
/// # Returns
|
||||||
///
|
///
|
||||||
@@ -1053,7 +1053,7 @@ fn materials_section(page: &Page<'_>, lecture: &crate::course::Lecture) -> Strin
|
|||||||
/// # Arguments
|
/// # Arguments
|
||||||
///
|
///
|
||||||
/// * `course` - the loaded course file.
|
/// * `course` - the loaded course file.
|
||||||
/// * `options` - the Markdown flavour. Links between entries stay on this
|
/// * `options` - the Markdown flavor. Links between entries stay on this
|
||||||
/// page.
|
/// page.
|
||||||
///
|
///
|
||||||
/// # Returns
|
/// # Returns
|
||||||
|
|||||||
@@ -337,7 +337,7 @@ pub fn student(
|
|||||||
));
|
));
|
||||||
}
|
}
|
||||||
// What meeting the target looks like, which is what to
|
// What meeting the target looks like, which is what to
|
||||||
// practise towards.
|
// practice toward.
|
||||||
if let Some(explanation) = course
|
if let Some(explanation) = course
|
||||||
.learning_targets
|
.learning_targets
|
||||||
.get(target)
|
.get(target)
|
||||||
|
|||||||
@@ -277,7 +277,7 @@ pub enum StimulusMode {
|
|||||||
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
#[serde(deny_unknown_fields)]
|
#[serde(deny_unknown_fields)]
|
||||||
pub struct Fields {
|
pub struct Fields {
|
||||||
/// The item's global id, `bank::item`. Useful printed in small grey type on a
|
/// The item's global id, `bank::item`. Useful printed in small gray type on a
|
||||||
/// review copy; never wanted on a student form.
|
/// review copy; never wanted on a student form.
|
||||||
#[serde(default = "yes")]
|
#[serde(default = "yes")]
|
||||||
pub uid: bool,
|
pub uid: bool,
|
||||||
@@ -438,7 +438,7 @@ pub struct RenderConfig {
|
|||||||
/// Anything else you want the template to see, carried through untouched.
|
/// Anything else you want the template to see, carried through untouched.
|
||||||
///
|
///
|
||||||
/// This is the escape hatch that keeps the crate out of your layout
|
/// This is the escape hatch that keeps the crate out of your layout
|
||||||
/// decisions. Tier colours, a `show-solutions` flag, a font stack, a watermark
|
/// decisions. Tier colors, a `show-solutions` flag, a font stack, a watermark
|
||||||
/// string: put it here and read it from `extra` in the template.
|
/// string: put it here and read it from `extra` in the template.
|
||||||
#[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
|
#[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
|
||||||
pub extra: BTreeMap<String, serde_yaml_ng::Value>,
|
pub extra: BTreeMap<String, serde_yaml_ng::Value>,
|
||||||
|
|||||||
@@ -6,7 +6,7 @@
|
|||||||
//!
|
//!
|
||||||
//! The same arrangement the exam export uses: this module decides what the
|
//! The same arrangement the exam export uses: this module decides what the
|
||||||
//! template is told, the template decides what it looks like, and the two meet at
|
//! template is told, the template decides what it looks like, and the two meet at
|
||||||
//! a marker comment. Nothing here knows about page size or colour.
|
//! a marker comment. Nothing here knows about page size or color.
|
||||||
//!
|
//!
|
||||||
//! Two slots are filled, both already defined for the exam path:
|
//! Two slots are filled, both already defined for the exam path:
|
||||||
//!
|
//!
|
||||||
@@ -149,7 +149,7 @@ impl Meta {
|
|||||||
out.insert("generator", generator);
|
out.insert("generator", generator);
|
||||||
out.insert("policy", policy);
|
out.insert("policy", policy);
|
||||||
// `students-tested` is the honest name: it is how many people sat this
|
// `students-tested` is the honest name: it is how many people sat this
|
||||||
// assessment, which is not the enrolment. `class-size` stays as an alias
|
// assessment, which is not the enrollment. `class-size` stays as an alias
|
||||||
// so a template forked before this change keeps working.
|
// so a template forked before this change keeps working.
|
||||||
out.insert("students-tested", Value::Int(self.n_students as i64));
|
out.insert("students-tested", Value::Int(self.n_students as i64));
|
||||||
out.insert("class-size", Value::Int(self.n_students as i64));
|
out.insert("class-size", Value::Int(self.n_students as i64));
|
||||||
|
|||||||
@@ -911,7 +911,7 @@
|
|||||||
|
|
||||||
#explain[
|
#explain[
|
||||||
Where the class sits on each kind of thinking. A drop from one level to the
|
Where the class sits on each kind of thinking. A drop from one level to the
|
||||||
next is expected; a cliff is worth reading as a gap in what was practised
|
next is expected; a cliff is worth reading as a gap in what was practiced
|
||||||
rather than in what was taught.
|
rather than in what was taught.
|
||||||
]
|
]
|
||||||
|
|
||||||
@@ -1052,7 +1052,7 @@
|
|||||||
#explain[
|
#explain[
|
||||||
One row per question, in the order they were numbered. Option letters are the
|
One row per question, in the order they were numbered. Option letters are the
|
||||||
bank's, not any one form's. See the guide above for what p, r, and D mean; the
|
bank's, not any one form's. See the guide above for what p, r, and D mean; the
|
||||||
r column is colour-coded against the conventional cut points.
|
r column is color-coded against the conventional cut points.
|
||||||
#{
|
#{
|
||||||
let dropped = cb-data.at("dropped-questions", default: ())
|
let dropped = cb-data.at("dropped-questions", default: ())
|
||||||
if dropped.len() > 0 [
|
if dropped.len() > 0 [
|
||||||
@@ -1146,7 +1146,7 @@
|
|||||||
// healthy item looks like on this exam, and the place to check a query about a
|
// healthy item looks like on this exam, and the place to check a query about a
|
||||||
// question nothing was wrong with. The flagged ones are already called out by
|
// question nothing was wrong with. The flagged ones are already called out by
|
||||||
// name in the triage lists above, so nothing is lost by putting them back among
|
// name in the triage lists above, so nothing is lost by putting them back among
|
||||||
// their neighbours here.
|
// their neighbors here.
|
||||||
// Dropped items come from their own list, since they carry no statistics and
|
// Dropped items come from their own list, since they carry no statistics and
|
||||||
// belong in none of the tables above. They belong here: the option spread is
|
// belong in none of the tables above. They belong here: the option spread is
|
||||||
// the evidence that justified dropping them, and re-running the report after a
|
// the evidence that justified dropping them, and re-running the report after a
|
||||||
@@ -1341,7 +1341,7 @@
|
|||||||
None of these #n #plural(n, "expectation", "expectations") rests on prior
|
None of these #n #plural(n, "expectation", "expectations") rests on prior
|
||||||
data, so they are predictions rather than calibrations. A prediction that
|
data, so they are predictions rather than calibrations. A prediction that
|
||||||
misses is a fact about the prediction: it does not flag the item, and it is
|
misses is a fact about the prediction: it does not flag the item, and it is
|
||||||
summarised here instead of appearing #n times in the tables above. Once
|
summarized here instead of appearing #n times in the tables above. Once
|
||||||
`coursebank calibrate` has written statistics back into the bank, a
|
`coursebank calibrate` has written statistics back into the bank, a
|
||||||
subsequent miss means the cohort or the teaching moved, and it will be
|
subsequent miss means the cohort or the teaching moved, and it will be
|
||||||
flagged.
|
flagged.
|
||||||
|
|||||||
@@ -281,7 +281,7 @@
|
|||||||
#let prose-pad = 1.5cm
|
#let prose-pad = 1.5cm
|
||||||
|
|
||||||
// The same right edge for prose that already sits in a gutter, so a note body
|
// The same right edge for prose that already sits in a gutter, so a note body
|
||||||
// lines up with the explanation above it. One centimetre is the 2.8em of number
|
// lines up with the explanation above it. One centimeter is the 2.8em of number
|
||||||
// column plus gutter at the default body size.
|
// column plus gutter at the default body size.
|
||||||
#let prose-pad-inset = prose-pad - 1cm
|
#let prose-pad-inset = prose-pad - 1cm
|
||||||
|
|
||||||
@@ -973,7 +973,7 @@
|
|||||||
let parts = ()
|
let parts = ()
|
||||||
|
|
||||||
// Both tiers. The target is what this question actually asked, which is the
|
// Both tiers. The target is what this question actually asked, which is the
|
||||||
// thing to practise; the objective is the row it counted toward in the table
|
// thing to practice; the objective is the row it counted toward in the table
|
||||||
// above, which is how a student tells whether one slip cost them a claim. The
|
// above, which is how a student tells whether one slip cost them a claim. The
|
||||||
// objective is absent when the two would be the same sentence.
|
// objective is absent when the two would be the same sentence.
|
||||||
let measured = q.at("measured", default: ())
|
let measured = q.at("measured", default: ())
|
||||||
@@ -988,8 +988,8 @@
|
|||||||
let target = [
|
let target = [
|
||||||
#text(weight: "bold")[This question asked you to:] #markup(m.target)
|
#text(weight: "bold")[This question asked you to:] #markup(m.target)
|
||||||
]
|
]
|
||||||
// What meeting the target looks like: the account to practise
|
// What meeting the target looks like: the account to practice
|
||||||
// towards, from the target's own explanation.
|
// toward, from the target's own explanation.
|
||||||
let explanation = m.at("explanation", default: none)
|
let explanation = m.at("explanation", default: none)
|
||||||
let lines = (target,)
|
let lines = (target,)
|
||||||
if explanation != none {
|
if explanation != none {
|
||||||
|
|||||||
+2
-2
@@ -70,7 +70,7 @@
|
|||||||
//! what must be true; [`lint`] advises on what is usually a mistake, and every rule
|
//! what must be true; [`lint`] advises on what is usually a mistake, and every rule
|
||||||
//! has a code you can silence.
|
//! has a code you can silence.
|
||||||
//!
|
//!
|
||||||
//! Small samples are labelled as such. Every statistic computed from a class of
|
//! Small samples are labeled as such. Every statistic computed from a class of
|
||||||
//! twenty-five is reported with the caveat it deserves rather than three decimal
|
//! twenty-five is reported with the caveat it deserves rather than three decimal
|
||||||
//! places of false precision.
|
//! places of false precision.
|
||||||
//!
|
//!
|
||||||
@@ -83,7 +83,7 @@
|
|||||||
//! hashing, ZIP writing, and the psychometrics are implemented here rather than
|
//! hashing, ZIP writing, and the psychometrics are implemented here rather than
|
||||||
//! pulled in — see [`date`], [`rng`], [`hash`], [`zipfile`], [`irt`]. For a tool
|
//! pulled in — see [`date`], [`rng`], [`hash`], [`zipfile`], [`irt`]. For a tool
|
||||||
//! whose job is to still open a course repository in five years, that tradeoff
|
//! whose job is to still open a course repository in five years, that tradeoff
|
||||||
//! favours fewer moving parts.
|
//! favors fewer moving parts.
|
||||||
//!
|
//!
|
||||||
//! ## Where to start
|
//! ## Where to start
|
||||||
//!
|
//!
|
||||||
|
|||||||
@@ -293,7 +293,7 @@ pub struct Measurement {
|
|||||||
/// it describes the answer or a distractor without a join.
|
/// it describes the answer or a distractor without a join.
|
||||||
#[serde(default, skip_serializing_if = "Vec::is_empty")]
|
#[serde(default, skip_serializing_if = "Vec::is_empty")]
|
||||||
pub key: Vec<String>,
|
pub key: Vec<String>,
|
||||||
/// Per-option behaviour, by option id.
|
/// Per-option behavior, by option id.
|
||||||
#[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
|
#[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
|
||||||
pub option_stats: BTreeMap<String, OptionStat>,
|
pub option_stats: BTreeMap<String, OptionStat>,
|
||||||
/// Fitted parameters, when the sample supported a fit.
|
/// Fitted parameters, when the sample supported a fit.
|
||||||
|
|||||||
+1
-1
@@ -401,7 +401,7 @@ pub struct GradeBand {
|
|||||||
/// The attainment word attached to the band, such as `Meritorious`.
|
/// The attainment word attached to the band, such as `Meritorious`.
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||||
pub attainment: Option<String>,
|
pub attainment: Option<String>,
|
||||||
/// A colour group, so a report can tint A bands alike without parsing
|
/// A color group, so a report can tint A bands alike without parsing
|
||||||
/// letters. Defaults to the letter's first character.
|
/// letters. Defaults to the letter's first character.
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||||
pub group: Option<String>,
|
pub group: Option<String>,
|
||||||
|
|||||||
+2
-2
@@ -512,7 +512,7 @@ pub struct Solution {
|
|||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||||
pub model_answer: Option<String>,
|
pub model_answer: Option<String>,
|
||||||
/// The worked reasoning a student can learn from: the derivation, the estimate,
|
/// The worked reasoning a student can learn from: the derivation, the estimate,
|
||||||
/// the argument for the key over its neighbours. This is the body of the
|
/// the argument for the key over its neighbors. This is the body of the
|
||||||
/// solutions document.
|
/// solutions document.
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||||
pub explanation: Option<String>,
|
pub explanation: Option<String>,
|
||||||
@@ -682,7 +682,7 @@ pub struct VariantCalibration {
|
|||||||
/// Upper-minus-lower-group discrimination index.
|
/// Upper-minus-lower-group discrimination index.
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||||
pub discrimination_index: Option<f64>,
|
pub discrimination_index: Option<f64>,
|
||||||
/// Per-option behaviour within this set, keyed by option id.
|
/// Per-option behavior within this set, keyed by option id.
|
||||||
#[serde(default, skip_serializing_if = "std::collections::BTreeMap::is_empty")]
|
#[serde(default, skip_serializing_if = "std::collections::BTreeMap::is_empty")]
|
||||||
pub option_stats: std::collections::BTreeMap<String, OptionStat>,
|
pub option_stats: std::collections::BTreeMap<String, OptionStat>,
|
||||||
/// Fitted item response theory parameters for this set.
|
/// Fitted item response theory parameters for this set.
|
||||||
|
|||||||
+1
-1
@@ -113,7 +113,7 @@ pub fn to_plain(src: &str) -> String {
|
|||||||
out.trim().to_string()
|
out.trim().to_string()
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Converts authoring markup to Pandoc-flavoured Markdown, for a Quarto document.
|
/// Converts authoring markup to Pandoc-flavored Markdown, for a Quarto document.
|
||||||
///
|
///
|
||||||
/// Subscripts and superscripts become Pandoc's `~x~` and `^x^`, the symbol table
|
/// Subscripts and superscripts become Pandoc's `~x~` and `^x^`, the symbol table
|
||||||
/// renders as Unicode, and the bold, italic, and inline-code spans are already
|
/// renders as Unicode, and the bold, italic, and inline-code spans are already
|
||||||
|
|||||||
@@ -178,7 +178,7 @@ fn e2106_a_brace_reference_that_does_not_resolve() {
|
|||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn e2106_an_old_reading_keeps_its_2_0_behaviour_for_targets() {
|
fn e2106_an_old_reading_keeps_its_2_0_behavior_for_targets() {
|
||||||
// A 2.0 reading with a mistyped `{t-...}` validated and rendered the braces
|
// A 2.0 reading with a mistyped `{t-...}` validated and rendered the braces
|
||||||
// literally. It still validates (the linter reports it); a new kind of
|
// literally. It still validates (the linter reports it); a new kind of
|
||||||
// reference in the same field is checked.
|
// reference in the same field is checked.
|
||||||
|
|||||||
Reference in new issue
Block a user