Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[workshop-sim] Improve: Add recovery scaffolding to the GitHub Actions intro labeling exercise

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#3,964 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
82/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
github-actions
Lĩnh vực
ci-cd, documentation

Hướng nghiên cứu

Bắt đầu bằng cách đọc 04-github-actions-intro.md và xác định bài tập "Label a sample workflow". Xem lại các hoạt động xung quanh về việc chuyển đến phần sau và workflow thực tế trước khi thêm công cụ hỗ trợ khôi phục. Chạy lại trình mô phỏng sinh viên của workshop và đánh giá định lượng; được xem là hoàn tất khi các hoạt động hiện có vẫn được giữ nguyên và điểm số không giảm hoặc được cải thiện, với ít lỗi do quá tải khái niệm hơn.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

feedback simulation workshop

Problem statement

04-github-actions-intro.md has both the lowest curriculum quality score in the corpus (5.39/10) and the highest raw failure count in the simulated core path (7,982 dropouts, all categorized as concept-overload). The step introduces 28 new concepts (per the rubric's new_concepts metric) with a troubleshootingSupport signal of 0 and a checkpoint_quality rubric score of 0.0/10 — learners who get lost in the trigger/job/runner/step/action vocabulary during the labeling exercise have no in-page guidance to recover, only a plain unchecked checklist at the end.

Proposed change

Add a short, structured troubleshooting/recovery aid immediately after the "Label a sample workflow" exercise — for example, a <details> block offering a worked walkthrough of one mislabeled term with an explanation of why it's that category, for learners who could not complete the exercise unaided. Do not remove the existing exercise, the "already know GitHub Actions" skip-ahead path, or the "Try it: Explore a real workflow" activity — all three already contribute positively to active_learning and should be preserved.

Failure mode classification

Learning barrier (conceptual density combined with a checkpoint_quality score of 0.0 and no recovery scaffolding — not an access/tooling issue, since this page requires no terminal or credentials).

Quantitative guardrail

Current scores for 04-github-actions-intro.md:

  • overall_score: 5.39/10 (lowest in the 30-step corpus)
  • Weakest rubric dimensions: checkpoint_quality (0.0/10), active_learning (3.9/10)
  • Learning KPI index: (2.0 × 3.9 + 2.0 × 0.0 + 1.5 × 5.0) / 5.5 = 2.78/10

The proposed recovery aid directly targets checkpoint_quality (by giving learners a way to self-verify and correct their labeling exercise) without reducing active_learning or scaffolding, since the exercise itself and its concepts remain unchanged. This should raise, not lower, the step's overall_score and learning KPI index.

Acceptance criteria

  • The shared curriculum quantitative assessment overall_score for 04-github-actions-intro.md stays flat or improves after the change
  • The step's learning KPI index (2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5 stays flat or improves
  • The existing labeling exercise, skip-ahead path, and "explore a real workflow" activity are preserved or strengthened — not removed or simplified to inflate completion
  • Re-running the workshop student simulator shows a reduced concept-overload failure count at 04-actions-intro without shrinking at-risk attempts at downstream steps

Suggested owner

workshop maintainer
Related to #3962

Generated by 🔬 Workshop Student Simulator · copilot · auto · 174.2 AIC · ⌖ 8.32 AIC · ⊞ 14.8K · ◷

  • expires on Sep 30, 2026, 7:13 AM UTC
Ngôn ngữ chính
JavaScript
Star
51
Fork
23
Merge trung bình
9 giờ 44 phút
Pull request đã merge (30 ngày)
25

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

  • Không có Dockerfile hay tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của githubnext/gh-aw-workshop

Tất cả issue của githubnext/gh-aw-workshop

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.