Fix Strands Agents documentation links in ADR#4584
Merged
SergeyMenshykh merged 5 commits intomainfrom Mar 10, 2026
Merged
Conversation
Replace 5 broken strandsagents.com URLs (returning 404) with stable GitHub source code links in docs/decisions/0001-agent-run-response.md. The Strands Agents docs site restructured from /api-reference/python/ to /api/python/, breaking the old links. Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Fix broken links in decisions documentation
Fix broken Strands Agents documentation links in ADR 0001
Mar 10, 2026
Replace GitHub source links with official strandsagents.com/docs/api/python/ documentation URLs in docs/decisions/0001-agent-run-response.md. Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
- Streaming: strandsagents.com/docs/user-guide/concepts/streaming/ - Structured output: strandsagents.com/docs/user-guide/concepts/agents/structured-output/ - AgentResult/stop_reason: strandsagents.com/docs/api/python/strands.agent.agent_result/#agentresult Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
Copilot
AI
changed the title
Fix broken Strands Agents documentation links in ADR 0001
Update Strands Agents links to use official documentation site
Mar 10, 2026
Replaced the duplicate hyperlink on `stop_reason` with inline code, keeping a single AgentResult link to the same URL. Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>
Copilot
AI
changed the title
Update Strands Agents links to use official documentation site
Fix Strands Agents documentation links in ADR
Mar 10, 2026
markwallace-microsoft
added
the
documentation
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the Agent Run Responses ADR to point AWS (Strands) references at specific, user-facing Strands Agents documentation pages instead of generic API refs/source links, improving the usefulness of the comparison tables.
Changes:
- Updated the Strands streaming link to the Strands “Streaming” concept documentation page.
- Updated the Strands structured output link to the Strands “Structured output” concept documentation page.
- Updated
AgentResultlinks to use the newer docs path and include an#agentresultanchor.
rogerbarreto
approved these changes
Mar 10, 2026
eavanvalkenburg
approved these changes
Mar 10, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation and Context
Strands Agents links in the agent-run-response ADR pointed to generic API reference pages or GitHub source. Reviewer feedback requested specific documentation URLs for streaming, structured output, and AgentResult, plus deduplication of an identical link used twice in the stop-reason row.
Description
Updated Strands Agents links in
docs/decisions/0001-agent-run-response.md:strands.agent.agentAPI ref →/docs/user-guide/concepts/streaming/strands.agent.agentAPI ref →/docs/user-guide/concepts/agents/structured-output/#agentresultanchor to existingstrands.agent.agent_resultlinksstop_reasonrendered as inline code, singleAgentResulthyperlink retainedContribution Checklist
🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.