Skip to content

Conversation

@IEvangelist
Copy link
Member

Contributes to #73

…d data persistence

- Introduced a new document on creating custom HTTP commands in Aspire, detailing the `WithHttpCommand` API and its usage.
- Added an overview of inner-loop networking in Aspire, explaining how endpoints and proxies work, along with launch profiles and Kestrel configurations.
- Documented the use of volumes and bind mounts for persisting data across Aspire project restarts, including examples for SQL Server and other resources.
Copilot AI review requested due to automatic review settings December 10, 2025 21:56
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 ports multiple documentation articles from Microsoft Learn to the Aspire documentation site, contributing to issue #73. The changes include new fundamental and AppHost documentation, CSS styling updates for improved layout behavior, and sidebar navigation configuration.

  • Added comprehensive documentation covering networking, external parameters, data persistence, annotations, and extensibility features
  • Updated CSS to handle responsive layout with custom breakpoints for mobile/desktop table of contents
  • Integrated new articles into the sidebar navigation structure

Reviewed changes

Copilot reviewed 19 out of 49 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
src/frontend/src/styles/site.css Adds responsive CSS for TOC display and custom breakpoints with media queries
src/frontend/src/content/docs/integrations/frameworks/javascript.mdx Adds empty lines before list items for consistent formatting
src/frontend/src/content/docs/integrations/databases/surrealdb.mdx Removes trailing whitespace and reformats aside content
src/frontend/src/content/docs/fundamentals/persist-data-volumes.mdx New article on using volumes and bind mounts for data persistence
src/frontend/src/content/docs/fundamentals/networking-overview.mdx New comprehensive guide on inner-loop networking and endpoints
src/frontend/src/content/docs/fundamentals/http-commands.mdx New article on creating custom HTTP commands
src/frontend/src/content/docs/fundamentals/external-parameters.mdx New guide on external parameters, secrets, and connection strings
src/frontend/src/content/docs/fundamentals/custom-resource-urls.mdx New article on defining custom resource URLs
src/frontend/src/content/docs/fundamentals/custom-resource-commands.mdx New guide on custom resource commands
src/frontend/src/content/docs/fundamentals/annotations-overview.mdx New comprehensive overview of resource annotations
src/frontend/src/content/docs/extensibility/interaction-service.mdx New detailed guide on the interaction service API
src/frontend/src/content/docs/app-host/withdockerfile.mdx New article on adding Dockerfiles to the app model
src/frontend/src/content/docs/app-host/persistent-containers.mdx New guide on persistent container lifetimes
src/frontend/src/content/docs/app-host/executable-resources.mdx New article on hosting external executables
src/frontend/src/content/docs/app-host/eventing.mdx New comprehensive guide on AppHost eventing APIs
src/frontend/src/content/docs/app-host/configuration.mdx New article on AppHost configuration options
src/frontend/src/content/docs/app-host/certificate-trust.mdx New guide on certificate trust customization
src/frontend/src/assets/whats-new/*.png Added new image assets for persistent containers
src/frontend/src/assets/fundamentals/networking/*.png Added networking diagram images
src/frontend/config/sidebar/sidebar.topics.ts Updated sidebar with new sections for fundamentals, AppHost, and extensibility
.github/prompts/migrate-from-learn.prompt.md Updated sidebar file path reference in migration instructions

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

@IEvangelist
Copy link
Member Author

Hey @copilot, please address review feedback. We have official support now for Vite - so showing it as an executable doesn't make sense. Instead, come up with another example please.

Copy link
Contributor

Copilot AI commented Dec 11, 2025

@IEvangelist I've opened a new pull request, #150, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot AI and others added 4 commits December 11, 2025 13:26
* Initial plan

* Replace Vite examples with webpack to reflect official Vite support

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* Add --host parameter to webpack example for container accessibility

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>
…ons between the two (#138)

* Add secure communication documentation and update site data version

- Created a new documentation file for secure communication between custom hosting and client integrations, detailing the flow of authentication credentials using MailDev and MailKit.
- Added prerequisites, code examples, and a summary of the implementation process.
- Introduced a new JSON file to specify the Aspire version as "13.0.1".

* More custom hosting bits.

* checkpoint...

* custom client rewrite

* Add MailDev resource parameters and update configuration for secure communication

* A few fixes

* Remove unnecessary ESLint disable comments from content configuration

* Refactor code structure for improved readability and maintainability

* Reapply missing JS integration

* Reapply ESLint disable comments for type safety in content configuration

* Format ESLint disable comments for better readability in content configuration

* Add deployment manifest format and publishing overview documentation

- Introduced a comprehensive guide on the deployment manifest format for Aspire apps, detailing the structure, resource types, and generation process.
- Added an overview of the publishing and deployment process in Aspire, explaining the CLI commands, parameter placeholders, compute environments, and hosting integration support.
- Included examples and best practices for generating artifacts and deploying applications using Aspire.

* Update deployment manifest generation instructions for clarity and accuracy

* Update integration links for PostgreSQL and EF Core consistency

* Add continue-on-error option for ESLint step in lint-validate workflow
…#123)

* Initial plan

* Replace all Tabs with syncKey="terminal" with OsAwareTabs component

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* Update OsAwareTabs to use named slots and reduce code duplication

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* refactor: replace Fragment with div in OsAwareTabs usage for improved readability

---------

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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants