Skip to content

docs: move YAML validation checkpoints earlier in Steps 7 and 11#107

Merged
pelikhan merged 2 commits into
mainfrom
copilot/workshop-sim-improve-validation-checkpoints
Jul 11, 2026
Merged

docs: move YAML validation checkpoints earlier in Steps 7 and 11#107
pelikhan merged 2 commits into
mainfrom
copilot/workshop-sim-improve-validation-checkpoints

Conversation

Copilot AI commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

Steps 7 and 11 were exposing students to multi-section YAML with no in-editor feedback until the final validate step, causing 6.1% and 3.0% dropout rates respectively.

Step 7 (07-your-first-workflow.md)

  • Add expected-output snippet (✔ hello-agent.md — valid) immediately after each incremental frontmatter sub-step (after on:, after permissions:) so students get a tight feedback loop at each authoring checkpoint
  • Add VS Code editor setup tip (YAML extension, tabSize: 2, formatOnSave) in "Before You Start" to prevent tab-vs-space errors before they happen

Step 11 (11-build-daily-status.md)

  • Promote "Common Mistakes" section to appear before "Build pass 1" — students now read the five common YAML pitfalls (tabs, missing ---, missing copilot-requests: write, etc.) before writing, not after failing
  • Update the cross-reference from "section below" → "section above" to match the new position

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Improve validation checkpoints in Steps 7 and 11 docs: move YAML validation checkpoints earlier in Steps 7 and 11 Jul 11, 2026
Copilot AI requested a review from pelikhan July 11, 2026 15:03
@pelikhan pelikhan marked this pull request as ready for review July 11, 2026 15:04
@pelikhan pelikhan merged commit b958479 into main Jul 11, 2026
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.

[workshop-sim] Improve: Move validation checkpoints earlier in Steps 7 and 11 (YAML authoring)

2 participants