Repository navigation
Python: [Bug]: python/README.md still says "Learn docs are coming soon" #7771
Description
Description
What happened: python/README.md ends its "Agent Framework Documentation" section with a placeholder line instead of a link:
- Learn docs are coming soon.What was expected: a link to the Learn documentation, which is published and already linked from the rest of the repo:
- root
README.mdlines 96-101 (Overview, Quick Start, Tutorials, User Guide, migration guides) dotnet/README.mdlines 31 and 35.github/ISSUE_TEMPLATE/config.yml, which points contributors at https://aka.ms/agent-framework- Python-pivot pages linked from Python sample and package READMEs, e.g.
python/packages/azure-cosmos-memory/README.md:475andpython/samples/04-hosting/foundry-hosted-agents/responses/observability/README.md:19
So the Python package README is the only place still telling readers the docs do not exist yet.
Steps to reproduce: open https://github.com/microsoft/agent-framework/tree/main/python and scroll to "Agent Framework Documentation".
Suggested fix
Replace the placeholder with the Learn links, Python-pivoted where the page supports pivots:
- [Learn Documentation](https://learn.microsoft.com/agent-framework/) - Official documentation
- [Quick Start](https://learn.microsoft.com/agent-framework/tutorials/quick-start?pivots=programming-language-python)
- [User Guide](https://learn.microsoft.com/en-us/agent-framework/user-guide/overview?pivots=programming-language-python)Package Versions
N/A - repository documentation (python/README.md), main at 26b9200.
Additional Context
The same list has a second stale entry one line above: [Design Documents] points to docs/design, which contains only python-package-setup.md. The design records (ADRs) live in docs/decisions. Both lines could be corrected in one PR.
Searched open and closed issues before filing; no existing report covers this.
Metadata
Metadata
Assignees
Labels
Type
Projects
- Status
Activity
[-]Python: [Bug]: python/README.md still says "Learn docs are coming soon"[/-][+].NET: Python: [Bug]: python/README.md still says "Learn docs are coming soon"[/+][-].NET: Python: [Bug]: python/README.md still says "Learn docs are coming soon"[/-][+]Python: [Bug]: python/README.md still says "Learn docs are coming soon"[/+]github-actions commentedon Aug 19, 2026
🤖 Automated triage reproduction notes (agent-authored — trust but verify)
Agent analysis
The bug is in python/README.md line 261 which reads "Learn docs are coming soon." — a stale placeholder. Replace it with Learn documentation links matching the pattern used in the root README.md (lines 96-98) and dotnet/README.md (lines 31, 35), using Python-pivoted URLs where available. The reporter also notes line 260's Design Documents link may point to the wrong directory (docs/design vs docs/decisions).
none