Skip to content

docs: refresh README highlights with plugin authoring and hyperlinks#385

Merged
danielmeppiel merged 5 commits intomainfrom
refactor/detect-package-type-and-readme
Mar 20, 2026
Merged

docs: refresh README highlights with plugin authoring and hyperlinks#385
danielmeppiel merged 5 commits intomainfrom
refactor/detect-package-type-and-readme

Conversation

@danielmeppiel
Copy link
Collaborator

Summary

Refresh the README Highlights section to lead with plugin authoring — the new paradigm of building Copilot, Claude, and Cursor plugins with full supply-chain tooling — and add hyperlinks on every highlight title to its most relevant docs page.

Changes

  • New top highlight: "Author plugins with a real supply chain" — links to /guides/plugins/
  • Hyperlinked all titles to the relevant docs page so users reach value fast
  • Renamed "Create & share" → "Pack & distribute" for accuracy (now covers both zip and plugin export)

URL mapping

Highlight Links to
Author plugins with a real supply chain /guides/plugins/
One manifest for everything /reference/primitive-types/
Install from anywhere /guides/dependencies/
Transitive dependencies /guides/dependencies/
Compile to standards /guides/compilation/
Content security /enterprise/security/
Pack & distribute /guides/pack-distribute/
CI/CD ready github.com/microsoft/apm-action

Lead with plugin authoring — the new paradigm of building Copilot,
Claude, and Cursor plugins with full supply-chain tooling. Add
hyperlinks on every highlight title pointing to the relevant docs page
so users reach value fast.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings March 20, 2026 10:29
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
danielmeppiel and others added 2 commits March 20, 2026 11:31
- Extract thumbnail from rendered video (title card at 2s mark)
- Add play button overlay for visual affordance
- Upload MP4 to v0.8.2 release as asset
- Insert centered thumbnail+link block between tagline and Why APM

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Reorder: core value props first, then security, then authoring/distribute.
Shorten the plugin authoring bullet to one line. Remove 'compile to
standards' — it's a detail, not a headline value prop.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the repository’s README “Highlights” to emphasize plugin authoring as a first-class use case and to make each highlight title a direct link into the most relevant documentation page.

Changes:

  • Adds a new top highlight focused on plugin authoring + supply-chain features, linking to the Plugins guide.
  • Hyperlinks all highlight titles to corresponding docs pages for faster user onboarding.
  • Renames “Create & share” to “Pack & distribute” and links it to the Pack & Distribute guide.

The release asset approach triggers a download instead of inline playback.
Removing until a proper inline solution is implemented.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@danielmeppiel danielmeppiel merged commit 6457eac into main Mar 20, 2026
6 checks passed
@danielmeppiel danielmeppiel deleted the refactor/detect-package-type-and-readme branch March 20, 2026 10:40
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.

2 participants