docs: Add MongoDB Entity Framework Core integration documentation#419
Open
mitchdenny wants to merge 42 commits intorelease/13.2from
Open
docs: Add MongoDB Entity Framework Core integration documentation#419mitchdenny wants to merge 42 commits intorelease/13.2from
mitchdenny wants to merge 42 commits intorelease/13.2from
Conversation
* 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
* Initial plan * Add documentation for .NET tool resources 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>
…ASPIREEXTENSION001 with version notes and suppression methods
…ASPIRECONTAINERSHELLEXECUTION001, ASPIREPIPELINES004, ASPIREPOSTGRES001, and ASPIREUSERSECRETS001 with improved descriptions and examples
… consistency across various components
* Clarify Azure AI Foundry format parameter documentation (#313) * Initial plan * Improve Azure AI Foundry format parameter documentation 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> * Configure WAF on the Azure Front Door (#324) * Configure WAF on the Azure Front Door These policies are required by Microsoft to prevent DDOS attacks on the site. * Fix invalid wafPolicy name * Update resource creation in Node.js docs (#333) Correction to invalid syntax. * Add generic "Upgrade Aspire" article under What's new (#322) * Initial plan * Add Upgrade Aspire article and update sidebar configuration Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> * Fix typo and remove broken link in Upgrade Aspire article Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> * refactor: streamline Upgrade Aspire article and remove legacy content * fix: update Upgrade Aspire article for clarity and accuracy * chore: remove outdated setup and tooling link from Upgrade Aspire article * fix: update link to installation instructions for Aspire CLI in Upgrade Aspire article * fix: clarify upgrade instructions and remove outdated content in Upgrade Aspire article --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> Co-authored-by: David Pine <david.pine@microsoft.com> * Add CLI telemetry details page * Fix * Fix * Fix * Improve doc-tester and doc-writer skills, fix cross-platform paths (#361) * Add doc-writer and doc-tester skills with hex1b MCP server - Add doc-writer skill with Aspire documentation guidelines - Add doc-tester skill for validating documentation accuracy - Include common documentation rules from PR feedback patterns - Configure hex1b MCP server in .mcp.json, .vscode/mcp.json, opencode.jsonc - Add .doc-tester-workspace/ to .gitignore - Add .vscode/mcp.json exception to .gitignore * Improve doc-tester and doc-writer skills, fix cross-platform paths Key changes: doc-tester skill: - Add Knowledge Source Awareness section to distinguish between intrinsic knowledge and documentation-derived knowledge - Add Documentation Takes Priority guidance - follow the docs being tested, not skill defaults - Add Aspire CLI installation guidance (GA, Dev, PR, and Staging builds) - Replace dotnet-specific commands with polyglot-friendly Aspire CLI (aspire add, aspire run) - Add Hex1b MCP tools section for terminal screenshots and asciinema recordings doc-writer skill: - Add AsciinemaPlayer component documentation for terminal recordings - Add Hex1b MCP tools guidance for creating new recordings - Add Aspire CLI installation guidance for testing documentation - Add aspire add recommendation for testing integration packages Other fixes: - Update Prettier extension recommendation to esbenp.prettier-vscode - Fix cross-platform path in frontend.esproj (backslash to forward slash) * Update Hex1b.McpServer to 0.66.0 --------- Co-authored-by: Mitch Denny <mitch@mitchdeny.com> * Fix PowerShell syntax in telemetry opt-out example --------- Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com> Co-authored-by: Tristan <Tri125@users.noreply.github.com> Co-authored-by: David Pine <david.pine@microsoft.com> Co-authored-by: Mitch Denny <midenn@microsoft.com> Co-authored-by: Mitch Denny <mitch@mitchdeny.com>
* Initial plan * Rename aspire mcp to aspire agent in CLI reference docs Co-authored-by: mitchdenny <513398+mitchdenny@users.noreply.github.com> * Final documentation updates complete Co-authored-by: mitchdenny <513398+mitchdenny@users.noreply.github.com> * Revert unrelated changes to aspire-integrations.json Co-authored-by: mitchdenny <513398+mitchdenny@users.noreply.github.com> * Add redirects for renamed aspire-mcp CLI pages The old aspire-mcp URLs are live on aspire.dev. Without redirects, merging the rename would break existing links from search engines, bookmarks, and external documentation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Update mcp-init.cast recording to show 'aspire agent init' Replace the typed command from 'aspire mcp init' to 'aspire agent init' with realistic human typing delays. All other content unchanged. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Rename mcp-init.cast to agent-init.cast Update filename and all references to match the renamed command. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: mitchdenny <513398+mitchdenny@users.noreply.github.com> Co-authored-by: Mitch Denny <mitch@mitchdeny.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…change (#416) Expand the breaking change section in aspire-13-2.mdx with: - Explanation of why the interface was deprecated - Full before/after code examples including ManagedIdentityId - Note about managed identity handling changes Update azure-container-registry.mdx with: - New section showing ContainerRegistry property access pattern - Deprecation notice linking to the breaking changes section Fixes #414 Co-authored-by: Mitch Denny <mitch@mitchdeny.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* docs: document image pull policy and Docker Compose PullPolicy Add reference documentation for the ImagePullPolicy API and Docker Compose PullPolicy property (Aspire 13.2 features). - Add 'Configure image pull policy' section to docker.mdx with enum values, WithImagePullPolicy() usage, Never policy example, and Compose mapping - Add 'Pull policy' section to docker-compose-to-apphost-reference.mdx with pull_policy mapping table - Add cross-reference links from aspire-13-2.mdx what's-new entries Closes #411 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix: correct PublishAsDockerComposeService calls to include required configure parameter The PublishAsDockerComposeService API has always required an Action<DockerComposeServiceResource, Service> configure callback. The parameterless overload shown in docs never existed in the Aspire API. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix: remove unnecessary PublishAsDockerComposeService from examples All resources are automatically published as Docker Compose services when a DockerComposeEnvironment is present. PublishAsDockerComposeService is only needed to customize the generated service definition. - Remove PublishAsDockerComposeService from intro, push, and registry examples - Add dedicated 'Customize a Docker Compose service' section showing the correct usage with a meaningful customization example Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Mitch Denny <mitch@mitchdeny.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
) * docs: add import/export telemetry data documentation Add documentation for the new Manage logs and telemetry dialog in the Aspire dashboard, which enables users to export, import, and remove telemetry data across resources. - Add new 'Manage data' subsection under 'Interact with telemetry' - Document export flow (ZIP with OTLP JSON, console logs, resources) - Document import flow (.zip and .json files, 100 MB limit) - Document granular remove via the Manage dialog - Update 'Remove data' section to reference new Manage dialog - Update Settings dialog description - Add dark-theme screenshots: manage-data-dialog, manage-data-expanded, settings-manage-telemetry - Update remove-all-telemetry screenshot (now shows Manage button) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: update screenshots to current dashboard UI - Update pause-telemetry.png with current Console logs page showing paused state with log content and 'Log capture paused' message - Update remove-telemetry-data.png with current Structured logs page showing Remove dropdown with current UI styling - Remove unused remove-all-telemetry.png (duplicate of settings-manage-telemetry.png after Settings dialog redesign) - Remove dead import for removeAllTelemetry in explore.mdx Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Mitch Denny <mitch@mitchdeny.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add comprehensive documentation for the new Aspire.MongoDB.EntityFrameworkCore client integration introduced in Aspire 13.2. New pages: - Get started guide (mongodb-efcore-get-started.mdx) - Client integration reference (mongodb-efcore-client.mdx) Updated pages: - EF Core overview: Added MongoDB card to icon grid - Sidebar: Added MongoDB under Entity Framework Core section - What's new (13.2): Fixed incorrect API name and added doc link Closes #412 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
mitchdenny
requested review from
IEvangelist,
JamesNK,
aaronpowell,
davidfowl,
eerhardt and
maddymontaquila
as code owners
Contributor
There was a problem hiding this comment.
Pull request overview
This pull request adds comprehensive documentation for the new Aspire.MongoDB.EntityFrameworkCore client integration introduced in Aspire 13.2, while also including numerous site-wide updates and improvements.
Changes:
- New MongoDB Entity Framework Core integration documentation (get started guide and client reference)
- Fixed API name in What's New 13.2 (
AddMongoDBEntityFramework→AddMongoDbContext) - CLI command restructure (
aspire mcp→aspire agent) - Site-wide updates including CSS improvements, new diagnostic warnings, Azure integration docs, and UI enhancements
Reviewed changes
Copilot reviewed 128 out of 144 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
mongodb-efcore-get-started.mdx |
New get started guide for MongoDB EF Core integration |
mongodb-efcore-client.mdx |
New client integration reference documentation (not in diff) |
overview.mdx (EF Core) |
Added MongoDB card and updated database list |
aspire-13-2.mdx |
Fixed incorrect API name |
| Various sidebar configs | Added MongoDB entry under EF Core section |
| CSS, i18n, CLI docs | Extensive unrelated site-wide updates |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Member
Author
|
Rebased against |
IEvangelist
force-pushed
the
release/13.2
branch
3 times, most recently
from
7f19910 to
232805e
Compare
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.
Summary
Adds comprehensive documentation for the new
Aspire.MongoDB.EntityFrameworkCoreclient integration introduced in Aspire 13.2.Closes #412
Changes
New pages
integrations/databases/efcore/mongodb/mongodb-efcore-get-started.mdx) — Walks through hosting setup, client package install,AddMongoDbContextregistration, DI usage, and next steps.integrations/databases/efcore/mongodb/mongodb-efcore-client.mdx) — CoversAddMongoDbContext,EnrichMongoDbContext, connection strings, configuration providers, inline delegates, multiple DbContexts, health checks, observability/telemetry, and MongoDB Driver vs EF Core comparison.Updated pages
AddMongoDBEntityFramework→AddMongoDbContext<MyDbContext>) and added link to new docs.Validation
All code examples were validated by creating a scratch Aspire project that:
AddMongoDbContext<MyDbContext>("mydatabase")with a real MongoDB container via AspireEnrichMongoDbContext, inline delegates, explicit database name, and config patterns all compile successfullyDoc site builds cleanly (4641 pages, 0 link validation errors).