Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[workshop-sim] Repair: Branch Copilot-access recovery guidance in Step 7 pre-flight check

Open Beginner friendly
  • Is something wrong?
#3,857 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 2 days

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
84/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github, github-actions, markdown
Domain
documentation

Research direction

Start with the IMPORTANT callouts in 07-your-first-workflow.md and 07d-confirm-model-access.md, then inspect the existing links and the billing side quest referenced by the curriculum. Add distinct recovery paths for no Copilot license and disabled organization Actions billing while preserving the test-prompt check and workflow-authoring activity; verify both links and the stated assessment guardrails.

Written by the indexing model from the issue text.

Description

feedback simulation workshop
Problem statement

07-your-first-workflow.md / 07d-confirm-model-access.md is now the highest-conditional-dropout step overall (20.52% among 22,472 at-risk runs) after correcting a simulator content-mapping defect that had previously masked this step's real failure driver. failureCategoriesByStep shows copilot-access-missing (4,065 failures) as the dominant cause — learners whose GitHub account/org has no usable Copilot access get stuck at the mandatory pre-flight check, and 3,844 of these are specifically tagged in the model's 07-first-workflow transition as blocking the required model-access activity. The current pre-flight check (run gh copilot, send a test prompt) correctly detects the problem but offers only a single link to 07d-confirm-model-access.md and github.com/settings/copilot for recovery — there is no explicit guidance for a learner whose organization has never enabled Copilot for Actions at all versus one who simply lacks a personal license.

Proposed change

Expand the [!IMPORTANT] callout in 07-your-first-workflow.md (and the parallel callout in 07d-confirm-model-access.md) to branch into two concrete remediation paths before sending the learner onward: (1) "no Copilot license at all" → link to obtaining/requesting a license, and (2) "license exists but org centralized billing for Actions is not enabled" → link directly to the relevant billing side quest section. This keeps the existing test-prompt pre-flight check intact and adds a decision branch rather than removing any instructions.

Failure mode classification

Access barrier — this is an environment/licensing/authentication gap, not a conceptual or scaffolding weakness. active_learning (6.3/10) and general instructional quality for this step are already comparatively strong.

Quantitative guardrail

Current scores for 07-your-first-workflow.md / 07d-confirm-model-access.md:

  • overall_score: 6.25/10
  • Weakest rubric dimension: checkpoint_quality (0.0/10)
  • Learning KPI index: (2.0 × 6.3 + 2.0 × 0.0 + 1.5 × 5.0) / 5.5 = 3.94/10

Because this is an access-barrier fix (clearer branching recovery guidance, not new concepts or removed practice), it should not lower active_learning or scaffolding; the added decision branch can only raise troubleshootingSupport/checkpoint_quality-adjacent content, so overall_score and the learning KPI index should stay flat or improve while conditional dropout at this step decreases.

Acceptance criteria
  • The shared curriculum quantitative assessment overall_score for 07-your-first-workflow.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 test-prompt pre-flight check and full workflow-authoring activity are preserved unchanged, not simplified or removed
  • The new branch clearly distinguishes "no Copilot license" from "org billing not enabled" and links each to its correct remediation resource
Suggested owner

workshop maintainer
Related to #3854

Generated by 🔬 Workshop Student Simulator · copilot · auto · 193.2 AIC · ⌖ 11.8 AIC · ⊞ 14.8K · ◷

  • expires on Sep 27, 2026, 9:51 AM UTC
Dominant language
JavaScript
Stars
49
Forks
20
Avg merge
7h 22m
Merged PRs (30d)
33

Getting set up

We have not checked this project's setup files yet. Start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/gh-aw-workshop

All issues in githubnext/gh-aw-workshop

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.