microsoft / microsoft/aspire.dev

[GitHub Discussions] Integrations documentation gaps

Open
#352 0 comments 0 reactions 1 assignee View on GitHub

@sebastienros is already working on this.

Since Feb 11, 2026.

external feedback
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_doc to read actual doc content
  • Date: February 2026

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.