Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 7, 2025

Conducted student walk-through of workshop to identify issues. Found 11 problems ranging from critical setup failure to documentation inconsistencies.

Fixed

pyproject.toml - Added missing build-system configuration

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[tool.setuptools]
py-modules = []

Without this, make setup fails immediately with setuptools package discovery error, blocking workshop start.

Documented Issues

WORKSHOP_ISSUES_REPORT.md - Comprehensive analysis (679 lines)

  • 11 issues with examples, root causes, fixes
  • Student experience perspective
  • Priority rankings (P0/P1/P2)

ISSUES_SUMMARY.md - Quick reference (86 lines)

  • Actionable checklist with time estimates
  • Table format for scanning

PR_SUMMARY.md - Reviewer guide

  • Investigation methodology
  • How to use reports

Critical Issues Requiring Attention

P0 (Workshop blockers):

  • CI references non-existent tests/ directory
  • Exercise 4: Instructions use Runner.run(agent, message) but solution uses Runner.run(agent, input=inputs, run_config=config)
  • Exercise 4: Missing import statements (Client, Worker, OpenAIAgentsPlugin) in instructions cause NameErrors

P1 (Student confusion):

  • Conflicting Temporal setup methods (notebook vs make temporal-up)
  • bootstrap.sh references non-existent make exercise-* targets
  • Exercise 4 labeled "optional" in timing but presented as regular exercise

Remaining P0 fixes estimated at 70 minutes. Workshop content is solid; issues are documentation consistency and instruction/solution mismatches.

Original prompt

This section details on the original issue you should resolve

<issue_title>Find any issues/problems/confusions with the workshop</issue_title>
<issue_description>Your objective is to navigate the workshop as a student and find any problems or confusing portions. Then report them.</issue_description>

Comments on the Issue (you are @copilot in this section)


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI changed the title [WIP] Identify and report issues in workshop navigation Document workshop issues and fix pyproject.toml setup failure Nov 7, 2025
Copilot AI requested a review from nadvolod November 7, 2025 20:51
Copilot finished work on behalf of nadvolod November 7, 2025 20:51
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.

Find any issues/problems/confusions with the workshop

2 participants