Skip to content
PlayOwl

Computers & Digital Literacy · Grade 12

Document Decisions, Sources and Limitations

Learners write the documentation that lets someone else trust, check and continue their work: decision records that keep the reasons for choices (and supersede rather than rewrite them), user-facing changelogs, citations for data, software and AI assistance, limitations sections that name threats to validity and their likely effects, and the habits and README that make an analysis reproducible. Worked examples come from the tool-library and bike-share capstones.

  • 4 lessons
  • About 115 minutes
  • Documentation check: 10 questions
  • Ways to answer: choose an answer, put code in order, trace code, highlight a text, match pairs and type a number
See plans Included with Family, Teacher and School plans. Open in PlayOwl

What learners will discover

  • Write decision records (context, options, decision, consequences) and user-facing changelogs, superseding rather than rewriting past decisions.
  • Cite data, software and AI assistance with the elements a reader needs: creator, title, version or date, location, access date and license; for AI, the tool, date, purpose and how the output was checked.
  • Write a limitations section covering scope, data and method, and identify internal, external, construct and statistical threats to validity.
  • Make work reproducible: keep raw data read-only, script or record every step, record versions, and write a README another person could follow.

Lessons

  1. Decision records and changelogs 7 steps3 practiceabout 27 min
  2. Citing data, software and AI assistance 6 steps4 practiceabout 27 min
  3. Limitations and threats to validity 7 steps4 practiceabout 28 min
  4. Reproducibility and the README 7 steps4 practiceabout 30 min
  5. Documentation check 10 questions at the end

Keep exploring

More 12th grade computer skills

Guide for grown-ups