Skip to content

Retrofit classes decks to literate programming #288

Description

@dbosk

Part of the notes-revision effort (see tracking issue). Lower priority: these
notes are already fully revised (memoir, narrative, ltnotes); this is only
the literate-programming retrofit.

Replace the \inputminted[firstline=…,lastline=…] presentation of example
programs with noweb chunks by converting each deck's contents.tex to
contents.nw, per steps 1–2 of the per-deck workflow in the tracking issue.
The examples/*.py files become tangled artifacts of the deck source.

Misconceptions input: while retrofitting, check the revised notes
against classes.tex in vt-prog-misconceptions (diagnostic item bank
quiz-classes-{start,end}.json): the misconception catalogue postdates the
classes revision, so add activities for any documented misconception the
notes do not yet target.

Decks

  • modules/classes/slides
  • modules/classes/slides-more
  • modules/classes/slides-even-more

Afterwards rebuild and re-review notes.pdf and slides.pdf; the prose
around the former line-range excerpts usually needs light editing since
chunk names now carry part of the narration.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions