Good Scaffold

​

Formula

GoodScaffoldScore = clamp01(
    0.25 · VisualScaffoldScore
  + 0.20 · TableScaffoldScore
  + 0.20 · bounded_labelled_code_example_score
  + 0.15 · InformationScentScore
  + 0.10 · section_summary_score
  + 0.10 · successful_internal_navigation_score
)

​

What each component captures

• Visual Scaffold — well-labelled, bounded, locally explained diagrams and images.
• Table Scaffold — tables in the 6–60 cell sweet spot.
• Bounded labelled code examples — code fences with explicit language tags and bounded sizes.
• Information Scent (Link Debt) — descriptive link text.
• Section summary — sections that open with a short summary paragraph.
• Internal navigation — anchor links resolve and there’s a usable navigation structure.

​

How DMI uses it

​

References

• Mayer, R. E. (2009). Multimedia Learning, 2nd ed. Cambridge University Press — multimedia principles behind well-labelled visuals and bounded examples.
• Carroll, J. M. (1990). The Nurnberg Funnel: Designing Minimalist Instruction for Practical Computer Skill. MIT Press — minimalist instruction principles supporting “bounded labelled code examples” and “section summary” credits. MIT Press record.

​

See also

• DMI — destination of the bonus credit.
• Visual Scaffold, Table Burden — largest contributors.