Skip to content

Dewain: Sync labs and workshops with main branch#233

Open
Dewain27 wants to merge 33 commits intoredesign/air-themefrom
dewain/sync-labs-workshops-with-main
Open

Dewain: Sync labs and workshops with main branch#233
Dewain27 wants to merge 33 commits intoredesign/air-themefrom
dewain/sync-labs-workshops-with-main

Conversation

@Dewain27
Copy link
Copy Markdown
Collaborator

@Dewain27 Dewain27 commented Mar 22, 2026

Summary

Aligns the redesign/air-theme branch with main so that all lab content and event definitions are current. Renames "workshops" to "events" throughout to match main's terminology and structure for easier future syncing.

Changes

Lab content synced from main

  1. Merged 19 commits from main including: Governance lab UC1 updates (Update Governance lab UC1: solution creation and DLP publish warnings #258), Tools lab UC2/UC4 simplification (Simplify Tools lab UC2 to use pre-provisioned agent flow #256, Update Tools lab UC4 disable knowledge settings #257), ALM lab clarity improvements (Remove Extra Credit section from ALM lab #252, Improve ALM lab clarity and guidance #253), Analytics-evaluations lab UX updates (Update analytics-evaluations lab for new Evaluations UX #249, Fix pass score step: General Quality has no pass score #250), Bootcamp lab resources links (Add Lab Resources links to bootcamp labs #248), MCS in a Day event rename (Remove old MCS in a Day event, rename V2 to replace it #246), Core-concepts lab fixes (Fix core-concepts lab issues from Atlanta bootcamp #245), Multi-agent lab UC4 removal (Remove UC4 (Fabric Data Agent) from multi-agent lab #244), M365 frontier agent use cases (Add Researcher and Analyst frontier agent use cases to M365 lab #234), and more
  2. Updated all existing lab READMEs under labs/ with the latest content from main

Workshops renamed to Events (matching main's terminology)

  1. Renamed _workshops/ collection to _events/ — all event definition files moved
  2. Renamed _layouts/workshop.html to _layouts/event.html
  3. Renamed workshops/index.md to events/index.md — updated title, description, and Liquid variables
  4. Updated _config.yml — collection name, permalinks (/events/:name/), and default layout
  5. Updated _data/navigation.yml — "Workshops" nav link changed to "Events"
  6. Updated homepage (index.md) — all workshop references changed to events (variables, hero stats, section title, card loop)
  7. Updated about/index.md — description and links updated
  8. Updated docs/REDESIGN-PREVIEW.md — all workshop references updated to events
  9. Updated .github/ISSUE_TEMPLATE/redesign-feedback.yml — dropdown options updated

Event definitions updated to match main

  1. Removed mcs-in-a-day-v2 — merged into mcs-in-a-day on main (PR Remove old MCS in a Day event, rename V2 to replace it #246)
  2. Updated mcs-in-a-day — replaced stale 5-lab lineup (referencing removed labs like public-website-agent, ask-me-anything-30-mins) with main's current 4-lab lineup
  3. Updated agent-buildathon-1month — added core-concepts-agent-knowledge-tools as Lab 3 per main, updated description
  4. Updated event ordering to match main (bootcamp=1, azure-ai=2, mcs-in-a-day=3, buildathon-1day=4, buildathon-1month=5)

Fixed _labs collection section values for All Labs page

  1. Fixed 11 _labs/*.md files with mismatched section: values that prevented them from appearing on the All Labs listing page

TOC sidebar fix

  1. Overrode _layouts/single.html — changed TOC generation from h_min=1 h_max=6 to h_min=2 h_max=3 so the "On this page" sidebar shows a flat, navigable list of h2/h3 lab sections (matching main's custom JS TOC behavior) instead of a single collapsed h1 entry

Test plan

  • Verify "Events" appears in top navigation (not "Workshops")
  • Verify /events/ index page shows 5 events with correct titles and lab counts
  • Confirm mcs-in-a-day-v2 no longer exists
  • Verify mcs-in-a-day event shows 4 labs matching main
  • Open a lab page and verify "On this page" TOC shows h2 sections and h3 sub-items
  • Verify all labs appear on the All Labs (/labs/) index page
  • Check homepage stats show correct event count
  • Verify About page links to /events/ not /workshops/

adilei and others added 9 commits March 6, 2026 13:58
Adds structured YAML issue forms with lab dropdowns, plus config for
blank issues and a link to Copilot Studio docs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* Fixes #165 updated images for SharePoint site creation

* Fixes #171 Web Search defaults to off, but is activated when adding URL knowledge items, students now will disable this option before testing their agent

* Fixes #173 - add step to Select Add channel

* fixes #175 - further changes to UI, only General Quality is there by default, added steps to configure an additional option

* fixes #176 - increased to 3-5 minutes

* fixes #177 - updated to reflect ui

* removed image for now

* Fixes #182 - fixed typo

* fixes #185 - changed chit chat example

* Fixes #188 - fixed typo Topic.Formula should have been Topic.relevantNewsForOpportunities

* Fixes #189 - removed reference to non old steps

* fixes #200 - fixed names to be consistent

* fixes #201 - added note

* fixes #184 #183 - simplified commission calculation
- UC1: Add UserID-(Solution Name) naming convention for solutions
- UC1: Use lab-provided username as publisher name
- UC3: Replace PROD environment provisioning with pre-provisioned ALM Prod
- UC3: Add schema name step with UserID requirement for agent creation
- UC3: Update all PROD references to ALM Prod throughout the lab
- Fix typo "read yto" → "ready to"

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
* Add presentations folder

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Add presentation decks to presentations folder

Add 13 Copilot Studio presentation decks covering Agent Builder, Core Concepts, Licensing, ALM, Component Collections, Orchestration, Tools Overview, Governance, SDK, Multi Agent, Autonomous Agents, Azure Better Together, and A365. Configure Git LFS tracking for pptx files.
…in README (#228)

Add version sections 3.0.0, 3.1.0, and 3.2.0 covering all changes from
January through March 2026. Replace inline changelog in README.md with a
link to CHANGELOG.md as the canonical change log location.
Co-authored-by: adilei <adileibowiz@microsoft.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Align the redesign/air-theme branch with main to ensure all lab
content and workshop definitions are current.
Dewain27 and others added 19 commits March 23, 2026 08:58
Add two new use cases to the agent-builder-m365 lab:

- Use Case #3: Deep analysis with the Researcher agent — uses two
  prompts (executive briefing with root-cause analysis, and gap
  analysis mapping problems to recommendations) against a sample
  hotel performance report PDF.

- Use Case #4: Financial modeling with the Analyst agent — uses a
  detailed NPV/IRR/DCF prompt to build investment prioritization
  analysis from the same report, demonstrating how Analyst can
  elevate analysis beyond the source material.

Includes the Contoso Grand Hotel Performance Report PDF (sample
document with 18 sections, tables, charts, and financial data)
and a clickable download link in the prerequisites.

Rebalances use case timings to 10/10/5/5 minutes (30 min total).
Updates prerequisites, learning targets, summary of learnings,
and conclusions to cover frontier agent capabilities.

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
Removed instructions for handling errors and streamlined the steps for creating a new Azure subscription and project.
The TOC anchor generation in Generate-Labs.ps1 was replacing special
characters (#, :, etc.) with hyphens, but Kramdown GFM strips them
entirely. This caused mismatches like "#-use-case--1--create..." vs
the actual heading ID "#-use-case-1-create...".

- Fix Generate-TOCFromHeadings to remove special chars instead of
  replacing with hyphens, matching Kramdown's ID algorithm
- Add fixMarkdownTocLinks() JS in lab layout for smooth scrolling
  and normalized fallback matching for edge cases (e.g. Unicode
  variation selectors from emoji like 🛠️)

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
UC4 is not currently functioning and needs troubleshooting before
it can be offered in the bootcamp. Removing it temporarily to avoid
confusion — it will be re-added once the Fabric Data Agent
integration is working properly.

Images for UC4 are retained in the images/ directory for when
the use case is restored.

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
Fixes issues identified during the Atlanta Architecture Bootcamp last week
in the core-concepts-agent-knowledge-tools lab:

- Update AI model references from GPT-4/GPT-4.1 to Claude Sonnet 4.6
- Update licensing guide link to April 2026 version
- Add copyable code blocks for agent name, URLs, and tool descriptions
- Fix copy button trailing newline in lab.html layout
- Add section to disable ungrounded responses with explanatory note
- Add section to set knowledge source as official with explanatory note
- Reorder sections: move Add Additional Knowledge Sources before Test
- Add note about browser refresh helping with indexing progress
- Add note about Bing URL depth limitation for web knowledge sources
- Add note allowing users to skip ahead to UC3 while file indexes
- Set weather tool Units input to custom value (Imperial/Metric)
- Update Prompt Analyzer: remove intent input, add tool description
- Add maker auth guidance for anonymous and API key-based APIs

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
* Remove old MCS in a Day event and rename V2 to replace it

- Remove the old mcs-in-a-day event which contained outdated labs
  that caused confusion during the Atlanta bootcamp (users found
  the old public-website-agent lab instead of the updated
  core-concepts-agent-knowledge-tools lab)
- Rename mcs-in-a-day-v2 to mcs-in-a-day since it fully replaces
  the original
- Replace public-website-agent with core-concepts-agent-knowledge-tools
  in the Agent Build-A-Thon (1 month) event
- Clean up all v2 references across layouts, CSS, issue templates,
  and scripts

* Remove orphaned public-website-agent and ask-me-anything-30-mins labs

These labs were only used by the old mcs-in-a-day event which has been
removed. They are no longer being maintained:

- public-website-agent: overlapped with core-concepts-agent-knowledge-tools
  and caused confusion at the Atlanta bootcamp
- ask-me-anything-30-mins: condensed version of ask-me-anything, created
  specifically for the old mcs-in-a-day event format

Removed from lab-config.yml, journey lab_orders, issue templates,
and README.md.

* Move Featured Events to top of home page and clean up event list

- Move Featured Events section above Choose Your Learning Journey
- Remove old mcs-in-a-day and mcs-in-a-day-v2 event cards, replace
  with single updated MCS in a Day card
- Reorder events: Bootcamp first, then MCS in a Day, Azure AI
  Workshop, Build-A-Thon (1 month), Build-A-Thon (1 day)

* Update stale references in docs and scripts

- Update EVENT_SYSTEM.md example to show current mcs-in-a-day lab order
- Update Generate-Labs.ps1 example to use core-concepts lab instead
  of removed public-website-agent

---------

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
)

The Generate-Labs.ps1 script auto-generates index.md during deploy,
overwriting manual edits. Updated the Build-RootHomepageContent
template to place Featured Events before Choose Your Learning Journey.

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
Add hyperlinks to the Lab Resources SharePoint page for all
"Lab Resources" references in bootcamp labs:
- agent-builder-m365: 1 reference
- mcs-alm: 4 references

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
#249)

- Update CSV import format: columns are now question and expectedResponse
  only (test methods configured after import, not in CSV)
- Update EvaluationAlwaysFail.csv to match new template format
- Add note explaining test methods are configured post-import
- Update character limits to 500 per question
- Remove step to delete follow-up responses in test canvas section

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
* Fix pass score step: General Quality has no pass score setting

General Quality no longer has a pass score setting in Copilot Studio.
Moved the pass score guidance to the Compare meaning step where it
actually applies.

* Update tip: test methods apply to all test cases in a set

Test methods are now associated at the set level, not per test case.
Updated the tip to clarify that all test cases must follow all
configured test methods.

* Remove per-question test method steps, keep General Quality default

Test methods are set-level, not per-question. Removed steps to add
Compare meaning and to edit individual test case evaluation methods.
The first test set now stays with General Quality as the default.

---------

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
* Fix note formatting and remove per-question Text Match references

- Fix indentation on preview feature note so it renders as a callout
- Remove step to change individual test case to Text Match (test
  methods are now set-level, not per-question)
- Update UC3 to remove Text Match verification step

* Add guidance on multiple test set types in conclusions

Recommend having multiple test sets for different purposes: Always
Pass for core functionality, Always Fail for safety guardrails,
and Non-Critical for general quality tracking.

---------

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
Removed the optional Extra Credit section (Git source control and
solution structure) and all references to it from prerequisites,
targets, table of contents, and use cases table.

Co-authored-by: Dewain Robinson <dewainr@microsoft.com>
* Improve ALM lab clarity: custom connectors, non-solution-aware settings, deployment patience

- Add prominent IMPORTANT note in UC1 about custom connectors requiring their own solution and deployment order
- Reinforce custom connector guidance in UC1 key takeaways
- Move non-solution-aware settings note from summary into UC3 where participants first deploy, with explanations for why each setting is not solution-aware
- Add NOTE in UC3 Test Your Pipeline about deployment taking time

* Remove incorrect warning about navigating away during deployment
…#254)

Since agents are created during the bootcamp, analytics data will not
be available (requires 24-48 hours). Explains there is no way to
pre-provision data and notes ongoing work with the Product Group to
provide sample visualizations for lab scenarios.
* Convert plain-text Copilot Studio URLs to markdown links

Fix 4 instances across bootcamp labs where copilotstudio.microsoft.com
was plain text instead of a clickable markdown link:
- mcs-alm
- component-collections
- mcs-tools
- mcs-multi-agent

* Use target="_blank" so Copilot Studio links open in a new tab
#256)

- Remove Create the Agent Flow, Define Input Parameters, Calculate
  Commission, and Create the Response Message sections
- Add pre-provisioned Calculate Sales Commission flow via Add a tool
- Move TIP about agent creation wait time to after step 3
- Make agent name/description copyable with code blocks
- Add step to turn off Web Search in Knowledge section
- Add agent instruction to ask for tool inputs one at a time
- Add NOTE about using instructions for agent behavior guidance
- Update test section to provide values conversationally one at a time
- Add expected verification results for both test scenarios
- Add step to turn off Web Search on Overview page first
- Add step to turn off Allow ungrounded responses in Settings
- Add step to verify Use information from the web is off
- Add NOTE explaining Web Search and Use information from the web
  are the same setting surfaced in two places
…ish warnings (#258)

- Add Create a Solution section after selecting Bootcamp Green environment
- Users create solution with their username for uniqueness in shared env
- Add NOTE about unique solution names requirement
- Update agent settings step to reference user-created solution
- Make Bootcamp Green and SharePoint URL easy to copy with code blocks
- Add DLP publish blocking warning to both Green and Yellow zone sections
Replace all bootcamp presentation decks with latest versions from the
Master Event Template. Adds new Host Deck (00) and fixes Core Concepts
filename from underscore to hyphen (02-04).
dependabot bot and others added 5 commits April 9, 2026 16:14
Bumps [addressable](https://github.com/sporkmonger/addressable) from 2.8.7 to 2.9.0.
- [Changelog](https://github.com/sporkmonger/addressable/blob/main/CHANGELOG.md)
- [Commits](sporkmonger/addressable@addressable-2.8.7...addressable-2.9.0)

---
updated-dependencies:
- dependency-name: addressable
  dependency-version: 2.9.0
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Brings in 19 commits from main including:
- Governance lab UC1 updates (#258)
- Tools lab UC2/UC4 simplification (#256, #257)
- ALM lab clarity improvements (#252, #253)
- Analytics-evaluations lab UX updates (#249, #250)
- Bootcamp lab resources links (#248)
- MCS in a Day event rename (#246)
- Core-concepts lab fixes (#245)
- Multi-agent lab UC4 removal (#244)
- M365 lab frontier agent use cases (#234)
- Various other fixes and updates

Files deleted in redesign/air-theme kept deleted (old theme artifacts).
Lab content conflicts resolved keeping main's latest content with
redesign branch formatting.
- Rename _workshops/ collection to _events/ to match main's terminology
- Rename workshops/ index to events/ index
- Rename _layouts/workshop.html to _layouts/event.html
- Update _config.yml collection and defaults
- Update navigation, homepage, about page, and docs references
- Remove stale mcs-in-a-day-v2 event (merged into mcs-in-a-day on main)
- Update mcs-in-a-day to match main's 4-lab lineup (drop removed labs)
- Update agent-buildathon-1month to include core-concepts lab per main
- Update event descriptions and ordering to match main
Override the Minimal Mistakes single.html layout to generate the
"On this page" TOC starting at h2 (h_min=2) instead of h1, and
capping at h4 (h_max=4). Lab content starts with an h1 title which
caused all h2/h3 sections to nest under a single collapsed item,
making the TOC unusable. Now the TOC shows a flat, navigable list
of lab sections matching main's behavior.
adilei pushed a commit that referenced this pull request Apr 15, 2026
Workshops → Events rename (atomic):
- Collection, config, nav, layouts, index page, homepage variables
- _workshops/ deleted, replaced by _events/

Lab page UI (from #232):
- Dark gradient hero header with updated pill colors
- Scrollbar fix (only tables/code blocks scroll)
- Duplicate H1 hiding via CSS sibling selectors
- TOC h3 expansion with indented styling

Content sync from main (from #233):
- 11 _labs/*.md section value fixes (labs missing from /labs/ index)
- All lab READMEs, images, PDFs synced from main
- Updated event definitions (bootcamp, mcs-in-a-day, buildathons)
- TOC fix in single.html (h2/h3 only)

Other:
- "Ask" → "Lab Assistant" rename
- Webchat overlay removed (page stays interactive)
- Homepage hero CTA: "Browse all events" / "Browse all labs"
- Events section moved above Learning Paths on homepage
- New issue templates (bug report, enhancement, new lab)
- Presentations (16 .pptx files)
- About page and preview doc updated for events

Skipped from PRs: session persistence, workshops dropdown,
masthead report button, agenda flyout, reworked feedback section,
lab.html JS from main, Gemfile.lock

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Dewain27 <Dewain27@users.noreply.github.com>
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.

4 participants