Draft
Conversation
IEvangelist
force-pushed
the
release/13.2
branch
4 times, most recently
from
98fa033 to
e95e6d8
Compare
IEvangelist
force-pushed
the
release/13.2
branch
2 times, most recently
from
c3c80a5 to
f29daa1
Compare
IEvangelist
force-pushed
the
release/13.2
branch
2 times, most recently
from
59bb625 to
c671510
Compare
* Initial plan * Add WithBun() documentation to JavaScript integration page Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> * Update Bun example to use specific version tag Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
) * Initial plan * Add documentation for deployment slot support to Azure App Service Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
- Created documentation for Azure Application Insights integration. - Created documentation for Azure Data Explorer (Kusto) integration. - Created documentation for Azure Log Analytics integration. - Created documentation for Azure Data Lake Storage integration. - Added `aspire doctor` command placeholder with redirect to main CLI command page. - Added documentation for `aspire ps` command to list running AppHost processes. - Added documentation for `aspire stop` command to stop running AppHost processes.
…LI commands and diagnostics
…#288) * Initial plan * Update ASPIRE008 diagnostic page for GenerateAssemblyInfo requirement Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> * Update project file samples to modern 13.x format Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
#277) * Add polyglot AppHost documentation for TypeScript, Python, Go, Rust, and Java * feat: enhance PivotSelector component with marginTop prop for better layout control (#302) docs: update Polyglot AppHost documentation with new features and usage examples docs: add link to Polyglot AppHost in resource model documentation docs: include Polyglot AppHost reference in get-started guide for broader language support style: import utility classes for padding and margin in site CSS style: create utils.css for reusable padding and margin utility classes * fix: format project structure in polyglot AppHost documentation for clarity --------- Co-authored-by: David Pine <david.pine@microsoft.com>
- Created a new translation guide document in MDX format to assist contributors in translating the aspire.dev documentation. - Added two new images for the translation page link and language selector in both light and dark themes. - Included a detailed section on supported languages, translation status, best practices, and tips for translators.
- Added FooterPreferences component for user preferences (theme, language, keyboard shortcuts). - Introduced FooterSocials component to display social media links. - Updated Footer.astro to include new components and adjusted layout for preferences. - Enhanced Header.astro to remove theme and language selectors, now located in the footer. - Implemented auto-detection of user language on first visit in Head.astro. - Adjusted styles for new components and improved responsiveness. - Updated translations in various languages to include "preferences".
- Changed hideOnClick prop in Head.astro from 'toggle' to true for improved clarity. - Removed fixed width and height from .starlight-sidebar-topics-icon to allow for flexible sizing. - Adjusted icon size in .social-icons and .starlight-sidebar-topics-icon for consistency and better responsiveness.
…json and pnpm-lock.yaml
#517) * Initial plan * Document DefaultAzureCredential breaking change in client integrations - Add new common doc page explaining default credential behavior - Add breaking change section in Aspire 13.2 what's new - Update all client integration docs to link to new credential doc Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com> * Add AZURE_TOKEN_CREDENTIALS env var explanation to default credential doc Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com> * Add deterministic credentials best practices link to credential behavior section Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com> * Simplify breaking change section in aspire-13-2.mdx to avoid duplicating credential doc Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com>
* Initial plan * Add diagnostics doc for ASPIREAZURE003 (Azure Virtual Networks) Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com>
* Update builder resource addition to use await * Update polyglot-apphost.mdx --------- Co-authored-by: David Pine <david.pine@microsoft.com>
- Rewrote aspire-vscode-extension.mdx with clearer structure: features overview, prerequisites, getting started, running/debugging, sidebar, commands, language support, settings, MCP, and feedback sections - Consolidated commands into a single flat table with all 16 commands - Added launch config examples for deploy, publish, pipeline steps, and per-language debugger customization - Fixed wrong marketplace link in python.mdx (ms-dotnettools.dotnet-aspire → docs page link) - Added extension cross-references to install-cli, first-app, add-aspire-existing-app, and dev-containers pages
* feat: build out infrastructure to generate API docs for both C# and TypeScript * fix: address copilot PR review suggestions for API docs components (#523) * Initial plan * fix: address PR review suggestions from copilot reviewer Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> * Refactor code structure for improved readability and maintainability * fix: refine sidebar collapse behavior for API reference pages * fix: update search component styles for better visibility on API reference pages * fix: update API reference links to point to C# APIs * feat(api): add support for standalone functions in TypeScript API reference - Implemented functionality to generate static paths for standalone functions without a qualified name. - Enhanced the TypeScript API reference pages to display function signatures, parameters, and return types. - Updated the sidebar to include functions alongside types and enums. - Improved the presentation of function details, including links back to parent types and method definitions. - Refactored existing code for better clarity and consistency in naming conventions (e.g., changed "Enumerations" to "Enums"). - Introduced a new InpageSearchSync component for managing search state in the URL. - Added a new method detail page for displaying individual method capabilities of handle types. * feat(api-reference): add unified search bar and version filter components - Introduced `ApiSearchBar` component for a unified search interface with kind filters and version dropdown. - Added `VersionFilter` component for version selection with checkbox toggles and "Select all" functionality. - Updated CSS styles for new components and adjusted existing styles for consistency. - Modified API sidebar links to include a specific path for C# references. - Enhanced page title styling for better visibility. * fix(api-reference): improve layout and overflow handling for breadcrumb and member card components * feat(breadcrumbs): implement content breadcrumbs functionality and integrate with Markdown content * feat(api-reference): add API reference path to the configuration * feat(banner): add announcement banner component with dismiss functionality * feat(thanks): add LicenseBadge component and license titles data * fix(deployment): update prerequisites for Azure deployment documentation * feat(terminal-showcase): enhance terminal showcase styling and add gradient effect feat(page-title): refactor page title component to use PageActionsPageTitle fix(api-pages): disable page actions for API reference pages style(css): remove unnecessary dropdown menu styling * refactor(PageTitle): simplify dropdown handling and improve API page title initialization * fix(api-reference): improve overflow handling for code, links, and preformatted text * feat(Search): add API search notice with links to C# and TypeScript references --------- Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
…d paths (#556) * Replace polyglot AppHost with TypeScript AppHost, fork getting started paths - Rename polyglot-apphost/migration/troubleshooting docs to typescript-apphost-* - Add redirects from old polyglot URLs to new typescript-apphost URLs - Fork prerequisites page with C# AppHost / TypeScript AppHost pivot - TypeScript path: Node.js + Docker + VS Code (no .NET required) - C# path: .NET SDK + Docker + VS Code/VS/Rider - Add TypeScript AppHost code example to 'What is Aspire' page - Add TypeScript AppHost structure tab to AppHost explainer page - Add TypeScript variant to SimpleAppHostCode component - Remove .NET SDK requirement from CLI install page - Replace 'polyglot' with 'multi-language' across all docs - Remove polyglotSupportEnabled from config examples (on by default) - Update sidebar: Polyglot -> TypeScript AppHost - Update all cross-references and link text site-wide - Add (Preview) to TypeScript AppHost page titles Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Remove accidentally committed screenshots Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix config settings table and CLI command references - Remove stale config flags from settings table and JSON example: dotnetSdkInstallationEnabled, minimumSdkCheckEnabled, orphanDetectionWithTimestampEnabled, packageSearchDiskCachingEnabled, runningInstanceDetectionEnabled, stagingChannelEnabled, polyglotSupportEnabled - Fix aspire run --debug (doesn't exist) to aspire run --log-level Debug Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Simplify pivot labels to C#/TypeScript, remove .NET aside Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Move C# extension recommendation into C# pivot only The VS Code C# extension was showing for both C# and TypeScript paths on the prerequisites page. Now only shown for C#. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix C#-first framing on What is Aspire page Change 'type-safe C#' to 'type-safe code' since the section now shows both C# and TypeScript AppHost examples. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add C#/TypeScript language toggle to landing page AppHostBuilder Add a language switcher to the interactive AppHost code builder on the landing page. TypeScript variants use Express for the API service (addNodeApp) while C# uses AddProject, matching each ecosystem's natural patterns. All 31 toggle combinations work in both languages. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address PR review: fix TS AppHost file tree, restore polyglot SEO keyword - Remove .aspire/settings.json from TypeScript AppHost file tree (only aspire.config.json is needed) - Add polyglot back as an SEO keyword alongside multi-language to preserve search ranking Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Add multi-language integration authoring guide New doc explaining how integration authors export their APIs for TypeScript AppHosts using [AspireExport], [AspireDto], [AspireExportIgnore], and [AspireUnion] attributes. Covers the analyzer (ASPIREEXPORT001-010), local development with project references in aspire.config.json, third-party attribute definitions, and a supported types reference. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Shorten sidebar label to 'Integration exports' Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Rename title to 'Multi-language integrations' Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Remove 'non-.NET' phrasing from integration authoring doc Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: David Pine <david.pine@microsoft.com> * Refactor code formatting and improve TypeScript SDK example in multi-language integration authoring guide * Address PR review feedback - Don't hardcode diagnostic count, describe scenarios generically - Show NoWarn in csproj instead of #pragma for ASPIREATS001 - Add ExposeProperties/ExposeMethods examples (per sebastienros) - Fix supported types: delegates, ILogger, IServiceProvider are compatible - Remove Third-party integrations section (implementation detail per davidfowl) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add cross-links from TypeScript AppHost articles to multi-language integrations Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Pine <david.pine@microsoft.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
…ion in release notes
* Reframe AI coding agents page: skill-first, MCP as subsection - Rename page from 'Configure the MCP server' to 'AI coding agents' - Lead with aspire agent init and the Aspire skill file - Add AGENTS.md migration section (skill file replaces it) - Move MCP server details to a linked sub-page (to be created) - Add AI/MCP/agent SEO keywords to site metadata - Update sidebar label and cross-references Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add Aspire MCP server sub-page Move MCP tools reference, security model, troubleshooting, and deployment considerations to a dedicated page under the AI coding agents section. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add Resource MCP servers page New page covering WithMcpServer(), WithPostgresMcp(), aspire mcp tools, and aspire mcp call for resources that expose their own MCP endpoints. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Nest MCP pages under AI coding agents sidebar group Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add TypeScript tabs to all AppHost samples, add missing MCP tools - Add C#/TypeScript tabs to all 4 AppHost code blocks across aspire-mcp-server.mdx and resource-mcp-servers.mdx - Add 5 missing MCP tools to the tools table: list_docs, search_docs, get_doc, doctor, refresh_tools Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add 'Why Aspire for coding agents' section to overview Explain the CLI's agent-friendly design: background start, wait, structured output, non-interactive mode, docs search, and how the skill file teaches agents these patterns. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix MCP server description — same data as CLI and dashboard Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Reframe MCP server — same visibility for humans and agents Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Lead 'Why Aspire' with runtime visibility, commands as supporting detail Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Rename 'Connection problems' to 'If your agent can't connect' Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Move MCP config JSON tabs from overview to MCP server page The AI coding agents overview now just links to the MCP server page for configuration details. The per-environment JSON examples live on the dedicated page where they belong. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Rename configure-mcp to ai-coding-agents, add redirect Rename the file to match its content. Update all 11 cross-references across the site. Add redirect from old URL. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: David Pine <david.pine@microsoft.com> * Apply suggestions from code review Co-authored-by: Maddy Montaquila (Leger) <maddyleger1@gmail.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Pine <david.pine@microsoft.com> Co-authored-by: Maddy Montaquila (Leger) <maddyleger1@gmail.com>
* Refresh Aspire CLI recordings for 13.2 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * feat: update Asciinema recordings and enhance documentation for CLI commands * Refine CLI recording playback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Swap CLI overview to banner cast Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Split banner and help recordings Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…Host docs (#563) - Delete typescript-apphost.mdx (first-app JS pivot covers this) - Delete typescript-apphost-troubleshooting.mdx (empty stub) - Delete typescript-apphost-migration.mdx (not needed yet) - Remove TypeScript AppHost sidebar group - Add multi-language architecture page under Architecture covering guest/host model, ATS type system, SDK generation, polymorphism flattening, startup sequence, token-based auth - Move TS troubleshooting to general troubleshooting page - Update all cross-references and redirects Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Replaced references to "Configure MCP" with "AI coding agents" in multiple documentation files to align with new setup instructions. - Removed the "Configure MCP" documentation file and created new files for "Use AI coding agents" and "Aspire MCP server" to provide clearer guidance on setting up AI coding agents and their interaction with the MCP server. - Added a new section on exposing MCP servers from Aspire resources, detailing how to interact with them using the CLI. - Updated various sections to improve clarity and ensure consistency across documentation regarding AI agent environments and MCP server usage.
…nfiguration" This reverts commit 8ed461c.
* Initial plan * Add aspire secret CLI command documentation pages and sidebar entries Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
…multi-language architecture guide
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.
The
release/13.2branch is currently deployed tohttps://aspiredev.netlify.app/.