Skip to content

Refresh README with improved structure and updated links#17

Merged
pdebruin merged 4 commits into
microsoft:mainfrom
mikekinsman:readme-refresh
May 11, 2026
Merged

Refresh README with improved structure and updated links#17
pdebruin merged 4 commits into
microsoft:mainfrom
mikekinsman:readme-refresh

Conversation

@mikekinsman
Copy link
Copy Markdown
Collaborator

Summary

Rewrites the README based on a team-reviewed proposal. Adds structure, requirements, scope, and updated links.

Changes

  • Restructured examples into Before / During / After Build sections
  • Added Requirements section — Copilot CLI + optional Node.js 22+
  • Added Scope and Limitations — event-scoped, dependency-driven, not offline
  • Added multi-event note — Build 2025 and Ignite 2025 also indexed
  • Updated Copilot CLI link to https://github.com/features/copilot/cli/
  • Replaced Contributing boilerplate with link to CONTRIBUTING.md
  • Added restart step to Quick Start for plugin activation

mikekinsman and others added 2 commits May 8, 2026 18:06
- Add Requirements, Scope and Limitations sections
- Restructure examples into Before/During/After Build
- Add multi-event note (Build 2025, Ignite 2025)
- Update Copilot CLI link to github.com/features/copilot/cli/
- Replace Contributing boilerplate with link to CONTRIBUTING.md

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@mikekinsman mikekinsman requested a review from pdebruin May 9, 2026 01:14
Copy link
Copy Markdown
Collaborator

@pdebruin pdebruin left a comment

Choose a reason for hiding this comment

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

Good restructure. The Before/During/After framing and the Scope and Limitations section are solid additions. Learn MCP link verified.

Two new workflows in the "After Build" table that I do not think are in SKILL.md yet:

  • "Diff your repo against Build updates"
  • "Show my Build notes"

Are these implemented in the skill, or aspirational? If the latter, worth flagging so users do not hit a dead end.

mikekinsman and others added 2 commits May 10, 2026 06:36
Keep the README scoped to documented capabilities.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@mikekinsman
Copy link
Copy Markdown
Collaborator Author

Thanks @pdebruin. Good catches on both.

"Diff your repo against Build updates" — reworded this to "See what changed for your project." It's the same dependency-scan flow as "what's new for my stack" in the Before Build table, just framed retrospectively. Clearer now without implying a separate feature.

"Show my Build notes" — The agent would probably know what this means, but you're right not an explicit flow in the skill. Removed it. We can add a journal read-back flow post-launch if there's demand.

@pdebruin pdebruin merged commit 9cf7812 into microsoft:main May 11, 2026
3 checks passed
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.

3 participants