microsoft / microsoft/aspire.dev
[GitHub Discussions] Integrations documentation gaps
@sebastienros is already working on this.
Since Feb 11, 2026.
- Dominant language
- MDX
- Stars
- 193
- Forks
- 87
- Avg merge
- 1d 22h
- Merged PRs (30d)
- 73
Description
Summary
Based on analysis of 820 GitHub discussions from dotnet/aspire.
Question counts:
| Integration | Questions |
|---|---|
| PostgreSQL/SQL Server/MySQL | 45+ |
| Redis | 15+ |
| Dapr | 20+ |
| YARP | 12+ |
| Orleans | 8+ |
| Custom integrations | 25+ |
Docs That Exist - Verified If They Answer Questions
✅ Questions Answered by Docs
| Question | Doc | Section That Answers |
|---|---|---|
| How to add PostgreSQL? | postgresql-integration |
Full guide with hosting + client |
| Redis caching setup | redis-integration |
Hosting + caching client |
| Basic Dapr sidecar | dapr-integration |
WithDaprSidecar() usage |
❌ Questions NOT Answered by Any Doc
| Question | Searched Docs | What's Missing |
|---|---|---|
| https://github.com/dotnet/aspire/discussions/9925: How to deploy Dapr to production? | dapr-integration |
No production/deployment section - ends at client integration |
| https://github.com/dotnet/aspire/discussions/13542: YARP with Azure Container Apps | None | No YARP integration doc exists |
| https://github.com/dotnet/aspire/discussions/10841: External PostgreSQL connection | postgresql-integration |
Only covers container, not external DBs |
| https://github.com/dotnet/aspire/discussions/9812: Orleans with Aspire clustering | orleans-integration |
Basic setup only, no clustering |
| https://github.com/dotnet/aspire/discussions/13123: Custom health check intervals | Various | No health check customization docs |
Critical Gaps - No Documentation Exists
❌ P0: YARP Integration
Questions: https://github.com/dotnet/aspire/discussions/13542, https://github.com/dotnet/aspire/discussions/11234, https://github.com/dotnet/aspire/discussions/10432
Status: No YARP documentation
Missing:
- YARP reverse proxy with Aspire
- YARP routes for microservices
- YARP on Azure Container Apps
❌ P1: External Database Connections
Questions: https://github.com/dotnet/aspire/discussions/10841, https://github.com/dotnet/aspire/discussions/9578, https://github.com/dotnet/aspire/discussions/8432
Status: All DB docs focus on containers only
Missing:
- Connecting to existing databases
- Azure managed databases (Flexible Server, etc.)
- Production database patterns
❌ P1: Dapr Production Deployment
Questions: https://github.com/dotnet/aspire/discussions/9925, https://github.com/dotnet/aspire/discussions/8234
Status: dapr-integration is dev-only
Missing:
- K8s with Dapr sidecars
- ACA with Dapr components
- Dapr component configuration
❌ P2: Custom Health Checks
Questions: https://github.com/dotnet/aspire/discussions/13123, https://github.com/dotnet/aspire/discussions/11892
Status: Health checks mentioned but not configurable
Missing:
- Custom health check intervals
- Health check endpoints customization
- Conditional health checks
Data Source
- GitHub Discussions: 820 total, 126 integration-related
- Verification method:
aspire-get_docto read actual doc content - Date: February 2026
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.