Align the overview message for what aspire is with the website and new messaging

[davidfowl]

Align the overview with the website.

We want to get rid of the word orchestration and replace it with inner loop (and remove it from the App Host ToC item as well).

@maddymontaquila this is yours 😄

[IEvangelist]

The official marketing website says "Dev-time orchestration":

Also, there's no mention of inner-loop in the dot.net site either?

[maddymontaquila]

https://github.com/dotnet/docs-aspire/blob/main/docs/get-started/aspire-overview.md @alistairmatthews I think using a mix of "dev-time orchestration" and "inner loop" is good, just general "orchestration" is where we start to get into k8s land

[davidfowl]

I think about this new slide:

We should be using this exact same language in the docs

[davidfowl]

I asked ChatGPT if overview has too many buzzwords:

Yes, the explanation contains a fair number of buzzwords like "streamline," "cloud-native," "observability," "scalability," and "resilience." While these terms may resonate with certain audiences, they risk making the explanation less approachable and more abstract, particularly for developers unfamiliar with the cloud-native ecosystem or for those seeking concrete, actionable details.

This is what I think we want to change. We landed on a pretty simple message that needs to updated in the docs. Then I gave it the visual above and asked how we could make the overview align with this message:

AI generated:

---

Got it. To make the .NET Aspire Overview align with the image but keep the docs factual and less marketing-oriented, the focus should be on what Aspire does, how it works, and why developers might find it useful—all presented without promotional language. Here’s a reworked factual summary:

---

Revised .NET Aspire Overview

What is .NET Aspire?

.NET Aspire is a framework for simplifying the development and deployment of distributed applications in .NET. It provides a collection of tools, templates, and NuGet packages that address common challenges in building cloud-native applications. Aspire is designed to help developers configure, test, and deploy applications efficiently by focusing on a consistent approach to managing dependencies, configurations, and integrations.

---

Core Features

1. Local Development Orchestration
   .NET Aspire simplifies local development by providing tools for defining and running interconnected services and dependencies, such as containers, projects, and cloud resources.

   • Automatically handles service discovery, connection strings, and configuration injection.
   • Supports common scenarios like adding and connecting resources (e.g., Redis, databases) directly in code.

   Example:

   var builder = DistributedApplication.CreateBuilder(args);
   var cache = builder.AddRedis("cache");
   builder.AddProject<Projects.MyFrontend>("frontend")
          .WithReference(cache)
          .WaitFor(cache);

   Aspire ensures consistency across applications by abstracting away the low-level details of service orchestration.

---

2. Integrations
   Aspire offers a range of pre-built NuGet packages to simplify connecting .NET applications to popular services, such as Redis, PostgreSQL, and Azure Service Bus. These integrations provide:

   • Pre-configured health checks, telemetry, and logging.
   • Automatic configuration through standardized interfaces.

   Example:

   builder.AddAzureServiceBusClient("servicebus");

   Aspire integrations ensure that applications are connected and monitored consistently, following best practices for distributed systems.

---

3. Project Templates and Tools
   Aspire includes project templates that provide a starting point for common application types. These templates are designed to:

   • Set up common patterns like telemetry, health checks, and service discovery.
   • Include defaults for dependency injection, logging, and configuration management.

   Example:

   builder.AddServiceDefaults();

   Templates can be used with Visual Studio, Visual Studio Code, and the .NET CLI for a seamless development experience.

---

4. Deployment Support
   While Aspire focuses on simplifying local development, it integrates with production-ready tools like CI/CD pipelines and containerized deployment systems.
   • Supports deploying apps to cloud environments or custom infrastructure.
   • Facilitates containerization workflows for consistent runtime environments.

---

Why Use .NET Aspire?

.NET Aspire provides a consistent approach to building and managing distributed .NET applications, reducing the effort required for:

• Configuring and running local development environments.
• Connecting to external services and managing dependencies.
• Deploying applications across cloud or hybrid infrastructures.

By automating many common tasks, Aspire enables developers to focus on application logic rather than infrastructure and setup.

---

Why This Works:

1. Focus on Facts: The text avoids promotional phrases and clearly explains Aspire's features and purpose.
2. Developer-Centric: Highlights practical benefits for developers without using ambiguous buzzwords.
3. Clarity: Explains each feature with examples and technical context.
4. Alignment with the Image: Matches the core ideas (development, integrations, deployment) but in a factual, technical tone.