Skip to content

Revise containers notes to the literate memoir pattern #279

Description

@dbosk

Part of the notes-revision effort (see the tracking issue for the full
per-deck workflow: literate contents.nw conversion, memoir notes,
narrative prose, pedagogical restructuring, \ltnote{} annotations,
LaTeX semantics, LO labels, review).

Note: the six split decks live on branch rework-containers (last commit
2022-10-31; merges cleanly — master has not touched this module since the
branch point, and the untracked slides-* directories in the working tree
are build artifacts left from having that branch checked out). The branch
renames slidesslides-dicts and splits the material per topic; the
deck READMEs carry YouTube/FeedbackFruits URLs of already-recorded videos
matching the split, so the structure is proven in use. Merge the branch
first
, then revise the six decks (the single slides deck ceases to
exist).

Maturity varies: slides-lists is substantial (~280-line contents, many
examples), slides-dicts moderate (inherits the old deck plus new search
examples), slides-tuples and slides-sets-stacks-queues are modest
drafts, and the two slides-example-* decks are skeletal exercise frames
that need most of their narrative written.

Misconceptions input: types.tex (container/sequence types) in vt-prog-misconceptions — documented
misconceptions with critical-aspect analyses and variation patterns to
design activities against (per-deck workflow step 5 in the tracking
issue); matching diagnostic item bank quiz-types-{start,end}.json.

Decks

modules/containers/slides-lists

  • Literate conversion (contents.nw, chunks replace \inputminted
    line ranges, Makefile + gitignore)
  • Memoir notes.tex
  • Narrative prose (notes read standalone)
  • Pedagogical restructuring (try-first, examples first, variation
    theory)
  • \ltnote{} annotations + ltnotes.bib
  • LaTeX semantics pass
  • Mnemonic LO labels in abstract.tex
  • Build + review pass

modules/containers/slides-tuples

  • Literate conversion (contents.nw, chunks replace \inputminted
    line ranges, Makefile + gitignore)
  • Memoir notes.tex
  • Narrative prose (notes read standalone)
  • Pedagogical restructuring (try-first, examples first, variation
    theory)
  • \ltnote{} annotations + ltnotes.bib
  • LaTeX semantics pass
  • Mnemonic LO labels in abstract.tex
  • Build + review pass

modules/containers/slides-dicts

  • Literate conversion (contents.nw, chunks replace \inputminted
    line ranges, Makefile + gitignore)
  • Memoir notes.tex
  • Narrative prose (notes read standalone)
  • Pedagogical restructuring (try-first, examples first, variation
    theory)
  • \ltnote{} annotations + ltnotes.bib
  • LaTeX semantics pass
  • Mnemonic LO labels in abstract.tex
  • Build + review pass

modules/containers/slides-sets-stacks-queues

  • Literate conversion (contents.nw, chunks replace \inputminted
    line ranges, Makefile + gitignore)
  • Memoir notes.tex
  • Narrative prose (notes read standalone)
  • Pedagogical restructuring (try-first, examples first, variation
    theory)
  • \ltnote{} annotations + ltnotes.bib
  • LaTeX semantics pass
  • Mnemonic LO labels in abstract.tex
  • Build + review pass

modules/containers/slides-example-guess

  • Literate conversion (contents.nw, chunks replace \inputminted
    line ranges, Makefile + gitignore)
  • Memoir notes.tex
  • Narrative prose (notes read standalone)
  • Pedagogical restructuring (try-first, examples first, variation
    theory)
  • \ltnote{} annotations + ltnotes.bib
  • LaTeX semantics pass
  • Mnemonic LO labels in abstract.tex
  • Build + review pass

modules/containers/slides-example-align-phonebook

  • Literate conversion (contents.nw, chunks replace \inputminted
    line ranges, Makefile + gitignore)
  • Memoir notes.tex
  • Narrative prose (notes read standalone)
  • Pedagogical restructuring (try-first, examples first, variation
    theory)
  • \ltnote{} annotations + ltnotes.bib
  • LaTeX semantics pass
  • Mnemonic LO labels in abstract.tex
  • Build + review pass

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions