docs: fill integration-specific gaps surfaced by Discord feedback analysis#459
Open
docs: fill integration-specific gaps surfaced by Discord feedback analysis#459
Conversation
- 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
IEvangelist
approved these changes
Feb 23, 2026
Member
IEvangelist
left a comment
IEvangelist
left a comment
There was a problem hiding this comment.
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
Contributor
There was a problem hiding this comment.
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.
src/frontend/src/content/docs/integrations/frameworks/wpf-winforms.mdx
Outdated
Show resolved
Hide resolved
…orms.mdx Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
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.
446 Discord questions identified concrete gaps in existing integration docs and the complete absence of any WPF/WinForms guidance. This PR addresses the highest-impact items across six integration areas.
JavaScript (
javascript.mdx)WithEnvironment("VITE_API_BASE_URL", api.GetEndpoint("https"))pattern +import.meta.envconsumption, with a note on build-time replacementAddViteAppcalls; Turborepo pipeline delegation via customdevscriptPython (
python.mdx)WithHttpsEndpoint+WithHttpsDeveloperCertificatewith Uvicorn SSL env var wiringWithExternalHttpEndpointsDapr (
dapr.mdx)AddDaprStateStore+WithReference; actor state store YAML (actorStateStore: "true") withResourcesDirectoryoptionPublishAsAzureContainerAppworkaroundYARP (
yarp.mdx)WithHttpsEndpoint+WithHttpsDeveloperCertificatefor HTTPS-to-HTTPS proxying; dev-certs trust reminderAzure PostgreSQL (
azure-postgresql-host.mdx)az postgres flexible-server db createas a manual workaround for subsequent additionsWPF / WinForms — new page (
wpf-winforms.mdx)Replaces the current documentation void ("can't find anything about WPF and Aspire") with explicit guidance:
AddProject-based local orchestration patternbuilder.Environment.IsDevelopment()Sidebar updated with new WPF and Windows Forms entry under Frameworks & runtimes.
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
javascript-integrationpython-integrationazure-postgresql-*dapr-integrationyarp-integrationredis-integrationkeycloak-integrationnet-maui-integration1. JavaScript/Vite/Node (102 questions)
Doc exists:
javascript-integration✅Gaps in existing doc:
Customer Quotes:
Action Items:
VITE_API_BASE_URL)2. Python (47 questions)
Doc exists:
python-integration✅Gaps:
Customer Quotes:
Action Items:
3. Dapr (43 questions)
Doc exists:
dapr-integration✅ (local dev only)Gaps:
Customer Quotes:
From #help:
Action Items:
4. YARP (41 questions)
Doc exists:
yarp-integration✅Gaps:
Customer Quote:
From #help:
Action Items:
5. PostgreSQL (63 questions)
Doc exists:
azure-postgresql-*✅Gaps:
Customer Quotes:
From #help:
Action Items:
6. Desktop Apps - WPF/WinForms (35 questions)
Doc exists: ❌ Only MAUI (
net-maui-integration)Customer Quotes:
From #help:
Action Items:
7. Database Version Upgrades
From #help:
Action Items:
Data Source
aspire-list_docsandaspire-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.