Skip to content

Enhance workshop docs views & nav#1715

Merged
mnkiefer merged 2 commits into
mainfrom
better-page-rendering
Jul 21, 2026
Merged

Enhance workshop docs views & nav#1715
mnkiefer merged 2 commits into
mainfrom
better-page-rendering

Conversation

@mnkiefer

Copy link
Copy Markdown
Contributor
  • Updates 00-welcome.md to clarify the workshop introduction, improve the explanation of agentic workflows, and make the language more engaging for new users.
  • Adds @fontsource-variable/mona-sans for Mona Sans font.
  • Does some clean up:
    • Removes the workshop/examples/event-provisioning/README.md file.
    • Removes the example Codespaces launcher configuration file workshop/examples/event-provisioning/devcontainer.json.
    • Removes the example organization profile README workshop/examples/event-provisioning/org-profile-README.md.

@mnkiefer mnkiefer self-assigned this Jul 21, 2026
@mnkiefer
mnkiefer requested a review from pelikhan July 21, 2026 06:59
@mnkiefer
mnkiefer merged commit cfd5402 into main Jul 21, 2026
5 checks passed
@mnkiefer
mnkiefer deleted the better-page-rendering branch July 21, 2026 07:06

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 📋 Guidelines Enforcer for #1715 · 31.9 AIC · ⌖ 5.4 AIC · ⊞ 5.7K

Comment thread workshop/00-welcome.md
# Welcome to our Agent Factory Tour!

<!-- reuse:event-org-readme-intro:start -->
By the end of this workshop, a real AI agent will create an issue with a summary of the activity in your repository over the latest 24h, every day, without you writing shell-script workflow code.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rule violated: Event provisioning surfaces

Offending change: This PR removes the <!-- reuse:event-org-readme-intro:start --> and <!-- reuse:event-org-readme-intro:end --> HTML reuse markers that wrapped the intro paragraph.

Guideline (Event provisioning surfaces):

When you change workshop onboarding language that should also appear in those provisioned surfaces, update the marked source blocks in workshop/00-welcome.md and keep the examples in sync.

The reuse markers exist so downstream event-provisioning tooling can extract and copy the intro text into org-profile READMEs and learner-repo Codespace launchers. Removing them breaks that sync contract.

Suggested fix: Restore the reuse markers around the intro paragraph:

<!-- reuse:event-org-readme-intro:start -->
By the end of this workshop, a real AI agent will create an issue with a summary of the activity in your repository over the latest 24h, every day, without you writing shell-script workflow code.
<!-- reuse:event-org-readme-intro:end -->

If the event-provisioning examples are intentionally being retired, also update the Event provisioning surfaces section of .github/workflows/guidelines.md in this PR to reflect that change.

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.

1 participant