Skip to content

docs: fill integration-specific gaps surfaced by Discord feedback analysis#459

Open
Copilot wants to merge 6 commits intomainfrom
copilot/fix-documentation-gaps
Open

docs: fill integration-specific gaps surfaced by Discord feedback analysis#459
Copilot wants to merge 6 commits intomainfrom
copilot/fix-documentation-gaps

Conversation

Copy link
Contributor

Copilot AI commented Feb 20, 2026 •
edited
Loading

  • Update JavaScript integration doc: add "Pass API URLs to Vite apps" (VITE_API_BASE_URL) and "Monorepo and Turborepo patterns" sections
  • Update Python integration doc: add "HTTPS configuration" and "Internal versus external service exposure" sections
  • Update Dapr integration doc: add "Configure Dapr state stores" (incl. actor state store YAML config) and "Deploy with Azure Container Apps" caution
  • Update YARP integration doc: add "HTTPS endpoints" section and "See also" links
  • Update Azure PostgreSQL hosting doc: add "Database creation after initial deployment" note with manual CLI workaround
  • Create new WPF/WinForms integration page (wpf-winforms.mdx) with support status, AddProject pattern, dev-only resources, limitations, and comparison with MAUI
  • Update sidebar to include new "WPF and Windows Forms" entry in Frameworks & runtimes section
  • Apply review feedback: wording/formatting improvements across all changed files
  • Fix typo: "redeploy you application" → "redeploy your application"
Original prompt

This section details on the original issue you should resolve

<issue_title>[Discord Feedback] Integration-specific documentation gaps</issue_title>
<issue_description>## Summary

Based on analysis of 20,415 Discord messages + 147 #help threads (April 2025 - February 2026).

Total integration questions: 446

Docs Verified via list_docs

Integration Doc Exists Slug
JavaScript ✅ javascript-integration
Python ✅ python-integration
PostgreSQL ✅ azure-postgresql-*
Dapr ✅ dapr-integration
YARP ✅ yarp-integration
Redis ✅ redis-integration
Keycloak ✅ keycloak-integration
MAUI ✅ net-maui-integration
WPF/WinForms ❌ None

1. JavaScript/Vite/Node (102 questions)

Doc exists: javascript-integration ✅

Gaps in existing doc:

Customer Quotes:

"Has anyone done monorepo/turborepo with Aspire? Wondering if it's possible to do a pnpm dev on the root of the monorepo and host / expose multiple apps within"

"I have react+vite in the frontend calling a minimal API. I can't get the API URL to work -always undefined-"

Action Items:

  • Monorepo/Turborepo patterns
  • Passing API URLs to Vite apps (VITE_API_BASE_URL)
  • TypeScript debugging (from #help: "How to debug TypeScript/Node.js apps in Aspire?")
  • Docker build troubleshooting for JS apps

2. Python (47 questions)

Doc exists: python-integration ✅

Gaps:

Customer Quotes:

"Ok. So I can force https in the python app in publish mode today to make it work without my hack?"

"Even for internal requests? I don't actually need the python api exposed publicly"

Action Items:

  • HTTPS/certificate configuration for Python apps
  • Internal vs external service exposure
  • Deployment patterns (aspire deploy with Python)
  • Docker build troubleshooting

3. Dapr (43 questions)

Doc exists: dapr-integration ✅ (local dev only)

Gaps:

Customer Quotes:

"I just redeployed my container apps that have WithDaprSidecar but the Azure portal now shows Dapr is disabled - what gives?"

"when using AddDaprStateStore, how do I configure it as an ActorStateStore?"

From #help:

"How to configure Dapr sidecars with PublishAsAzureContainerApp in Aspire 13?"

Action Items:

  • Azure Container Apps + Dapr deployment
  • Dapr settings preservation on redeploy
  • Actor state store configuration
  • Migration from Aspire 9 to 13 for Dapr

4. YARP (41 questions)

Doc exists: yarp-integration ✅

Gaps:

Customer Quote:

"Just updated to Aspire 13.1 and tried using AddYarp with an https endpoint. My Yarp configuration proxies calls to an ASP.NET Core Razor Pages site that is using https as well."

From #help:

"Azure + Yarp + JavaScriptApp - Container app context not found"

Action Items:

  • HTTPS endpoint configuration with YARP
  • YARP + JavaScript app for Azure deployment

5. PostgreSQL (63 questions)

Doc exists: azure-postgresql-* ✅

Gaps:

Customer Quotes:

"I'm looking for Aspire Hosting Extension support for Azure PostgreSQL Flexible Server with Elastic Clusters (Preview)"

"AddAzurePostgresFlexibleServer().AddDatabase() doesn't create new databases in Azure via azd after the initial server creation"

From #help:

"SSL connection not applied to EF Migrations with Postgres"

Action Items:

  • Elastic Clusters support status
  • Database creation after initial deployment
  • SSL/TLS configuration for Azure PostgreSQL
  • EF Migration SSL issues

6. Desktop Apps - WPF/WinForms (35 questions)

Doc exists: ❌ Only MAUI (net-maui-integration)

Customer Quotes:

"is wpf and aspire a thing? cant really find anything about."

"how do you handle dev only resources? i thought i may just build a wpf client that starts in dev with all too"

From #help:

"MAUI apps not launching from Aspire on Mac with Rider"

Action Items:

  • WPF integration guide (or explicit "not supported" statement)
  • WinForms integration
  • Dev-only resources pattern
  • IDE-specific troubleshooting (Rider on Mac)

7. Database Version Upgrades

From #help:

"How to handle database container version upgrades when volume data is incompatible?"

"Resources no longer get CosmosDb connection string going from 13.0.1 to 13.1"

Action Items:

  • Database container version upgrade guidance
  • Volume migration patterns
  • Breaking changes migration guide (13.0 → 13.1)

Data Source

  • Discord channels: #💫│general, #🔵│azure, #🔨│building-resources
  • Help threads: 147 from #🆘│help
  • Total messages: 20,415
  • Date range: April 2025 - February 2026
  • Verified against: aspire-list_docs and aspire-search_docs</issue_description>

<agent_instructions>Please address this issue, while using the `.github/skills/...

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

@IEvangelist
Address integration-specific documentation gaps from Discord feedback
c33b92c 
- JavaScript: Add VITE_API_BASE_URL pattern and monorepo/Turborepo sections
- Python: Add HTTPS configuration and internal vs external service exposure sections
- Dapr: Add state store + actor state store config, and ACA deployment note
- YARP: Add HTTPS endpoints section and See also links
- Azure PostgreSQL: Add database creation after initial deployment note
- New WPF/WinForms page with explicit support status and dev-only patterns
- Sidebar: Add WPF and Windows Forms entry to Frameworks & runtimes

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix integration-specific documentation gaps for WPF/WinForms docs: fill integration-specific gaps surfaced by Discord feedback analysis Feb 20, 2026
Copilot AI requested a review from IEvangelist February 20, 2026 21:03
IEvangelist
IEvangelist approved these changes Feb 23, 2026
View reviewed changes
Copy link
Member

@IEvangelist IEvangelist left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR looks good so far, but let's double check it for accuracy by using the .github/skills/doc-tester/SKILL.md skill. Please also consider all new comments and feedback/suggestions. @copilot

@IEvangelist IEvangelist marked this pull request as ready for review February 23, 2026 21:24
Copilot AI review requested due to automatic review settings February 23, 2026 21:24
Copilot AI reviewed Feb 23, 2026
View reviewed changes
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request addresses integration-specific documentation gaps identified through analysis of 446 Discord questions across six integration areas. The PR adds comprehensive guidance for JavaScript/Vite API configuration and monorepo patterns, Python HTTPS and service exposure configuration, Dapr state stores and Azure Container Apps deployment, YARP HTTPS endpoints, Azure PostgreSQL database provisioning behavior, and creates a new WPF/Windows Forms integration guide.

Changes:

  • Added JavaScript/Vite guidance for passing API URLs to frontend apps and monorepo/Turborepo patterns with pnpm
  • Added Python HTTPS configuration with Uvicorn SSL setup and internal vs. external service exposure patterns
  • Added Dapr state store configuration, actor state store YAML examples, and Azure Container Apps deployment guidance with Dapr sidecar preservation
  • Added YARP HTTPS endpoint configuration for HTTPS-to-HTTPS proxying scenarios
  • Added Azure PostgreSQL database creation timing documentation with manual CLI workaround
  • Created new WPF/Windows Forms integration guide with dev-only resource patterns, limitations, and MAUI comparison
  • Updated sidebar configuration to include new WPF/Windows Forms entry

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
src/frontend/src/content/docs/integrations/reverse-proxies/yarp.mdx Added HTTPS endpoints section with developer certificate configuration and "See also" links
src/frontend/src/content/docs/integrations/frameworks/wpf-winforms.mdx New comprehensive guide covering WPF/Windows Forms integration with AddProject pattern, service discovery, dev-only resources, limitations, and MAUI comparison
src/frontend/src/content/docs/integrations/frameworks/python.mdx Added HTTPS configuration with Uvicorn SSL and internal vs. external service exposure sections
src/frontend/src/content/docs/integrations/frameworks/javascript.mdx Added API URL passing with VITE_ environment variables and monorepo/Turborepo patterns
src/frontend/src/content/docs/integrations/frameworks/dapr.mdx Added state store configuration, actor state store YAML setup, and Azure Container Apps deployment section
src/frontend/src/content/docs/integrations/cloud/azure/azure-postgresql/azure-postgresql-host.mdx Added database creation timing documentation with azd provision note and manual az CLI workaround
src/frontend/config/sidebar/integrations.topics.ts Added "WPF and Windows Forms" entry under Frameworks & runtimes section

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@IEvangelist
Update src/frontend/src/content/docs/integrations/frameworks/wpf-winf…
7528561 
…orms.mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@IEvangelist IEvangelist enabled auto-merge (squash) March 6, 2026 13:28
alistairmatthews
alistairmatthews reviewed Mar 17, 2026
View reviewed changes
Copy link
Contributor

@alistairmatthews alistairmatthews left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot Please implement my suggested changes.

@alistairmatthews
Apply review feedback: wording and formatting improvements
09cad6a 
- azure-postgresql-host: fix wording for database creation sentence
- dapr: lowercase 'actor' in actor state store heading and description
- javascript: bold monorepo/pnpm/Turborepo terms; add anchor link to runtime config section in Aside
- python: reword HTTPS note, rename heading to 'Internal versus external', reword tip
- wpf-winforms: expand 'UI' acronym, update step heading, comment, dev-only wording, table rows

Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Mar 17, 2026 •
edited
Loading

@copilot Please implement my suggested changes.

Done in commit 09cad6a. All suggested changes have been applied across the five files.

This PR looks good so far, but let's double check it for accuracy by using the .github/skills/doc-tester/SKILL.md skill. Please also consider all new comments and feedback/suggestions. @copilot

Verified the changed pages using the doc-tester approach (browsed the local dev server with Playwright). All pages rendered correctly — key content like "HTTPS is needed primarily", "Internal versus external service exposure", "monorepo layouts", "Turborepo orchestrates", the Aside link to the runtime config section, and the WPF/WinForms table rows all appeared as expected. No broken links or rendering errors were found in the new or updated content.

Copilot AI requested a review from alistairmatthews March 17, 2026 16:54
alistairmatthews
alistairmatthews reviewed Mar 17, 2026
View reviewed changes
Copy link
Contributor

@alistairmatthews alistairmatthews left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot Please implement my suggested change.

@alistairmatthews
Fix typo: 'redeploy you application' → 'redeploy your application'
753a1c4 
Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Mar 17, 2026

@copilot Please implement my suggested change.

Fixed in commit 753a1c4.

Copilot AI requested a review from alistairmatthews March 17, 2026 16:58
alistairmatthews
alistairmatthews approved these changes Mar 17, 2026
View reviewed changes
Copy link
Contributor

@alistairmatthews alistairmatthews left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. Ready to merge.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@alistairmatthews alistairmatthews alistairmatthews approved these changes

@eerhardt eerhardt Awaiting requested review from eerhardt eerhardt is a code owner

@aaronpowell aaronpowell Awaiting requested review from aaronpowell aaronpowell is a code owner

+1 more reviewer

@IEvangelist IEvangelist IEvangelist approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

@IEvangelist IEvangelist

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Discord Feedback] Integration-specific documentation gaps

4 participants

@IEvangelist @alistairmatthews