Skip to content

Replace links to SDK GitHub repositories with links to specific packages used by samples - #347

Merged
Jim Daly (JimDaly) merged 7 commits into
mainfrom
link-to-packages
Oct 21, 2026
Merged

Jim Daly (JimDaly) merged 7 commits into
mainfrom
link-to-packages

Conversation

@JimDaly

@JimDaly Jim Daly (JimDaly) commented Oct 19, 2026 •

Copy link
Copy Markdown
Member

While reviewing the Microsoft Agent 365 samples being added to the samples browser.

I found a common pattern in each README. They all contained sentences like this:

These links refer to the GitHub repository containing the source code for the respective group of packages that are part of the SDK. This PR takes the position that most customers do not need to visit those repos unless they want to contribute or raise issues. Some will - but the vast majority will only install the packages. The information about packages is more valuable and can replace the sentences referring to the GitHub repos. This information is more specific and useful.

The changes in this PR:

  • Stop driving readers to repos that contain information not relevant for most.
  • Provide links that identify the specific packages that the sample uses. These represent how customers should consume the language specific SDKs via their package registry pages.

Copilot AI balanced review requested due to automatic review settings October 19, 2026 22:52
@JimDaly
Jim Daly (JimDaly) requested a review from a team as a code owner October 19, 2026 22:52
@github-actions

Copy link
Copy Markdown

⚠️ Deprecation Warning: The deny-licenses option is deprecated for possible removal in the next major release. For more information, see issue 997.

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

Copilot AI 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.

🟢 Approval recommended

The documentation-only changes support package discovery and locale-neutral navigation, with no identified blocking issues.

No open issues 🎉

What changed in this PR

Updates Agent 365 documentation to direct sample users to package registries rather than SDK source repositories. No runtime code changes.

Changes:

  • Adds sample-specific NuGet, PyPI, and npm package links.
  • Removes redundant SDK repository links from updated resource lists.
  • Makes Microsoft Learn links locale-neutral across documentation and templates.
File Description
README.md Makes developer documentation links locale-neutral.
python/​openai/​sample-agent/​README.md Adds PyPI links and normalizes documentation links.
python/​observability-with-otlp/​README.md Links the observability package and locale-neutral guidance.
python/​observability-with-langgraph/​README.md Adds observability package links.
python/​observability-with-azure-monitor/​README.md Adds observability package links.
python/​google-adk/​sample-agent/​README.md Adds PyPI links and normalizes setup links.
python/​crewai/​sample_agent/​README.md Adds PyPI links and updates resources.
python/​claude/​sample-agent/​README.md Adds PyPI links and updates resources.
python/​autonomous/​github-trending/​README.md Makes Microsoft Learn links locale-neutral.
python/​agent-framework/​sample-agent/​README.md Adds PyPI links and updates resources.
prompts/​Cursor IDE Prompt.md Makes reference and example URLs locale-neutral.
nodejs/​vercel-sdk/​sample-agent/​README.md Adds npm links and updates resources.
nodejs/​perplexity/​sample-agent/​README.md Adds npm links and updates resources.
nodejs/​openai/​sample-agent/​README.md Adds npm links and updates resources.
nodejs/​n8n/​sample-agent/​README.md Makes setup and resource links locale-neutral.
nodejs/​langchain/​sample-agent/​README.md Adds npm links and updates resources.
nodejs/​langchain/​quickstart-before/​README.md Makes quickstart links locale-neutral.
nodejs/​devin/​sample-agent/​README.md Adds npm links and updates resources.
nodejs/​copilot-studio/​sample-agent/​README.md Adds npm links, including the Copilot Studio client.
nodejs/​claude/​sample-agent/​README.md Adds npm links and updates resources.
nodejs/​claude/​quickstart-before/​README.md Makes the Agents SDK documentation link locale-neutral.
nodejs/​autonomous/​github-trending/​README.md Makes Microsoft Learn links locale-neutral.
dotnet/​w365-computer-use/​sample-agent/​README.md Makes prerequisite and guidance links locale-neutral.
dotnet/​semantic-kernel/​sample-agent/​README.md Adds NuGet links and updates resources.
dotnet/​autonomous/​github-trending/​sample-agent/​README.md Makes Microsoft Learn links locale-neutral.
dotnet/​agent-framework/​sample-agent/​README.md Adds NuGet links and updates resources.
CLAUDE.md Makes the developer documentation link locale-neutral.
agent-platforms/​salesforce/​apex-observability/​README.md Makes Microsoft Learn links locale-neutral.
agent-platforms/​salesforce/​apex-observability/​docs/​design.md Makes the authentication reference locale-neutral.
.claude/​skills/​generate-readme/​SKILL.md Makes README template links locale-neutral.

Review effort: Balanced

@JimDaly
Jim Daly (JimDaly) merged commit 6a68896 into main Oct 21, 2026
42 checks passed
@JimDaly
Jim Daly (JimDaly) deleted the link-to-packages branch October 21, 2026 16:26
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