Skip to content

Curriculum improvements: Lab restructuring, quizzes, and bug fixes - #6

Merged
scarolan merged 2 commits into
mainfrom
curriculum-improvements
Dec 5, 2025
Merged

scarolan merged 2 commits into
mainfrom
curriculum-improvements

Conversation

@scarolan

@scarolan scarolan commented Dec 5, 2025

Copy link
Copy Markdown
Owner

Summary

This PR contains comprehensive curriculum improvements based on pedagogical review and bug fixes for all open issues.

Major Changes

Lab Structure

  • Split Lab 8 into two focused labs:
    • Lab 8a: Label Manipulation & Historical Comparisons (label_replace, label_join, offset)
    • Lab 8b: Subqueries, Ranking & Missing Data (subqueries, topk/bottomk, absent)

Assessment

  • Added checkpoint quizzes after each difficulty tier:
    • Beginner Quiz (6 questions) - after Lab 2
    • Intermediate Quiz (7 questions) - after Lab 4
    • Advanced Quiz (10 questions) - after Lab 10

Engagement

  • Added narrative scenarios to advanced labs (8a, 8b, 9, 10) for better learner engagement
  • Added mermaid diagram explaining histogram bucket structure in Lab 9

Bug Fixes (Closes all 5 issues)

Other Improvements

  • Fixed Lab 9 navigation (now correctly links to Lab 10)
  • Fixed Lab 10 ending (proper congratulations message)
  • Updated Lab 7 navigation to point to Lab 8a
  • Moved copilot-instructions.md to correct location
  • Updated README to reflect new 12-lab structure
  • All 86 tests pass

Testing

  • All PromQL queries validated against live Prometheus
  • Query coverage check passes (all lab queries have tests)

Sean Carolan added 2 commits December 5, 2025 13:29
… narrative

Major changes:
- Split Lab 8 into Lab 8a (Label Manipulation & Offset) and Lab 8b (Subqueries, Ranking & Missing Data)
- Added checkpoint quizzes after each difficulty tier (Beginner, Intermediate, Advanced)
- Enhanced labs with scenario-based narratives for better engagement
- Added mermaid histogram diagram to Lab 9
- Fixed Lab 9 navigation to point to Lab 10
- Fixed Lab 10 ending with proper congratulations and quiz link
- Moved copilot-instructions.md to correct location (.github/)
- Updated README to reflect new lab structure (12 labs)
- Added tests for new Lab 8b queries
- Excluded quiz files from coverage check (illustrative examples)

All 86 tests pass.
Issue #1: Add histogram traffic generator
- Created Scripts/histogram_traffic_generator.py (cross-platform)
- Created Scripts/histogram_traffic_generator.sh (bash version)
- Updated Scripts/README.md with usage instructions
- Generates HTTP traffic to Prometheus for Lab 9 histogram data

Issue #2: Fix redundant 'sum by (instance)' with single instance
- Updated Lab 4: Added clarifying note about multi-instance pattern
- Updated Lab 5: Simplified CPU saturation query (removed redundant grouping)
- Updated Lab 6: Changed to simple sum() for network query
- Updated corresponding test queries in Tests/queries.py

Issue #5: Remove synthetic histograms from deck 9
- Removed 'Building Synthetic Histograms' slide section
- Updated objectives (removed synthetic histogram objective)
- Updated summary (removed synthetic histogram point)
- Updated speaker notes throughout

All 86 tests pass.
@scarolan
scarolan merged commit 2dbf88e into main Dec 5, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant