Skip to content

Restructure & renumber; remove Products Page; advanced MCP optional #503

Description

@jongalloway

Summary

Part of the converged workshop rewrite (milestone #1). Structural cleanup after the new hands-on parts land: renumber the workshop, remove the Products Page, and fix all cross-references. Do this once, late, after part content settles.

Content

  • Renumber Parts for the new flow (console chat → manual RAG → template reveal → providers → MCP → Copilot SDK → Agent Framework → deploy)
  • Remove the Products Page section outright (redundant with RAG + template content; doesn't serve the agentic through-line). Rationale is focus, not time. Content stays in git history if ever needed.
  • Preserve the concept: fold structured output (AI → typed objects) into Part 2 (Part 2 - Build a chat app by hand (console, MEAI) #499) so we don't lose it
  • Advanced MCP stays optional/bonus (locked): keep MCP Basics required (its tool feeds the Agent Framework unit); Enhanced MCP + MCP Publishing are optional — only students who get ahead reach them. Rationale: MCP + MAF content takes real time, and students commonly struggle with the basic connection-string / user-secrets configuration.
  • Pace content across the ~8-hour, two-part HOL (8:30–5:30 less 1h lunch); badge optional/bonus sections so pacing has slack
  • Fix cross-links between parts (relative links, README.md next/prev pointers)
  • Remove Products-page images/assets and fix any image paths that move
  • Update CI/build paths and part references in .github/copilot-instructions.md and any workflows
  • Update the root README.md part index / lab overview

Acceptance criteria

  • All internal links resolve; CI builds the renamed/renumbered solutions.
  • Products Page is fully removed from the workshop flow; no dangling links or references.
  • Structured-output concept is preserved in Part 2.
  • Advanced MCP (Enhanced + Publishing) is clearly badged optional/bonus.

Metadata

Metadata

Assignees

No one assigned

    Labels

    github-models-retirementUpdates to accommodate GitHub Models retirement (July 30, 2026)

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions