Add new application graph concept page (#642)

* Add application graph page

* Remove app-model page

* Update spelling

* Address feedback

* Apply suggestions from code review

Co-authored-by: Will <[email protected]>

* Update app graph paragraph

---------

Co-authored-by: Will <[email protected]>

.github/config/en-custom.txt

@@ -420,4 +420,5 @@ gg
 kubernetesMetadata
 daprSidecar
 manualScaling
+roadmap
 Balancer

docs/content/_index.md

@@ -10,7 +10,7 @@ weight: 1
 
 {{< cardpane >}}
 {{< card header="**App-centric**" >}}
-Teams [describe their application]({{< ref appmodel-concept >}}) services and relationships, rather than just a list of infrastructure.
+Teams [describe their application]({{< ref application-graph>}}) services and relationships, rather than just a list of infrastructure.
 
 <img src="app-diagram.png" alt="Screenshot of a Radius applications diagram" style="width:100%" >
 {{< /card >}}
@@ -41,7 +41,7 @@ Teams can offload the complexity of wiring-up applications and let Radius employ
 <table style="max-width:600px;margin-top:5%">
   <tr>
     <td style="width:25%;text-align:center">
-      <a href="{{< ref appmodel-concept >}}"><img src="connect-logo.svg" alt="Connections logo" style="width:40%"></a>
+      <a href="{{< ref application-graph>}}"><img src="connect-logo.svg" alt="Connections logo" style="width:40%"></a>
     </td>
     <td style="width:25%;text-align:center">
       <a href="{{< ref networking >}}"><img src="network-logo.svg" alt="Networking logo" style="width:40%"></a>

docs/content/author-apps/application/index.md

@@ -10,7 +10,7 @@ tags: ["application"]
 
 ## Overview
 
-An [application]({{< ref appmodel-concept >}}) is the primary resource that contains all of your services and relationships.
+An [application]({{< ref application-graph>}}) is the primary resource that contains all of your services and relationships.
 
 ## Extensions
 

docs/content/concepts/application-graph/index.md

@@ -0,0 +1,82 @@
+---
+type: docs
+title: Radius Application Graph
+linkTitle: Application graph
+description: Learn how the Radius application graph allows you to model your entire application
+weight: 200
+---
+
+## Radius applications
+
+Radius offers an [application resource]({{< ref "/author-apps/application" >}}) which teams can use to define and deploy their entire application, including all of the compute, relationships, and infrastructure that make up the application. Since the graph of relationships between deployed resources is much more descriptive than a basic list of resources, the Radius application graph can automate complex deployment tasks and enable rich visualization experiences.
+
+<img src="application.png" alt="A diagram showing an application and all it's resources" width=400px >
+
+## Graphs are better than lists
+
+Within an application deployed with Radius, developers can express both the resources (_containers, databases, message queues, etc._), as well as all the relationships between them. This forms the Radius application graph. This graph is powerful because it allows Radius to understand the relationships between resources, and automate the deployment and configuration of your application. Plus, it allows you to visualize your application in a way that is more intuitive than a list of resources.
+
+<img src="list-to-graph.png" alt="A diagram showing the move from a set of infrastructure lists to a graph of resources" width=600px >
+
+## Automate your application deployment
+
+Because Radius now has all the relationships and requirements of an application, it can be deployed and configured automatically. Developers no longer need to specify all the identity, networking, or other configuration that is normally required, and operators don’t need to write custom deployment scripts.
+
+For example, if you want a container to read from an Azure Storage Account without using Radius, this normally requires creating managed identities, RBAC roles, identity federation, Kubernetes service accounts, and more. With Radius, developers can define a single connection from their container to a Storage Account, and Radius sets up all the required configuration automatically.
+
+<img src="graph-automation.png" alt="A diagram showing a connection from a Radius container to an Azure storage account resulting in managed identities, role-based access control, and CSI drivers." width=600px >
+
+## Self-documenting applications
+
+The Radius application graph also allows your application to be self-documenting, where developers and operators can query and reason about the same application definition. Instead of multiple views of logs, infrastructure, and code, Radius provides a single source of truth for your application.
+
+<img src="dashboard.png" alt="A mockup of a dashboard UI showing an application, its resources, and its connections" width=700px >
+
+> **Note:** A Radius dashboard is still on the roadmap, but in the meantime you can use the [Radius API]({{< ref api-concept >}}) to build your own visual experiences today.
+
+## Mine the app graph API
+
+The Radius application graph is also exposed as an API, allowing you to build your own visualizations, workflows, and more on top of Radius. Learn more in the [API docs]({{< ref api-concept >}}).
+
+For example, I can get the status of my `frontend` container, and get its definition and its connections to other resources:
+
+```bash
+GET /planes/radius/local/resourceGroups/default/providers/Applications.Core/containers/frontend
+```
+
+```
+{
+  "name": "frontend",
+  "type": "Applications.Core/containers"
+  "id": "/planes/radius/local/resourceGroups/default/providers/Applications.Core/containers/frontend",
+  "properties": {
+    "container": {
+      "image": "nginx:latest",
+      "env": {...},
+      "ports": {...},
+    },
+    "environment": "myenvironment",
+    "application": "myapp"
+  },
+  "connections": {
+      "backend": {
+        "source": "/planes/radius/local/resourceGroups/default/providers/Applications.Core/containers/backend",
+      },
+      "storage": {
+        "source": "/planes/azure/subscriptions/ee3dbd5a-68b4-4eea-bc48-f064009e6ff9/resourceGroups/myrg/providers/Microsoft.Storage/storageAccounts/mystorage",
+        "iam": {
+          "kind": "azure",
+          "roles": [
+            "Storage Blob Data Reader"
+          ]
+        }
+      }
+    },
+}
+```
+
+## Next step
+
+Now that you have an understanding of the Radius app graph, learn how you can deploy Radius applications to prepared landing zones with Radius Environments:
+
+{{< button text="Radius Environments" page="environments-concept" color="success" >}}

docs/content/concepts/overview/_index.md

@@ -27,7 +27,7 @@ At the heart of Radius is a new **application resource**, with an accompanying s
 
 <img alt="Diagram showing modeling an app with Radius" src="cloud-apps-radius.png" width="600px" />
 
-These new resources form the [**Radius app model**]({{< ref appmodel-concept >}}), which allow you to:
+These new resources form the [**Radius app model**]({{< ref application-graph>}}), which allow you to:
 
 - Visualize the entire application, including its dependencies and relationships
 - Investigate cross-app health and diagnostics, including dependencies and connections
@@ -88,4 +88,4 @@ As teams onboard to Radius and begin deploying across platforms, the tooling and
 
 Now that you have an overview of Radius, learn more about the Radius app model:
 
-{{< button text="Learn about the Radius application model" page="appmodel-concept" size="btn-lg" color="success" >}}
+{{< button text="Learn about the Radius application model" page="application-graph" size="btn-lg" color="success" >}}

docs/content/getting-started/quickstarts/quickstart-dapr/dapr-microservices-add-dapr/index.md

@@ -42,9 +42,9 @@ You can choose between a Redis container or Azure Table Storage
 
 Radius captures both logical relationships and related operational details. Examples of this include: wiring up connection strings, granting permissions, or restarting components when a dependency changes.
 
-The [`connections` property]({{< ref "appmodel-concept" >}}) is used to configure relationships between from a service to another resource.
+The [`connections` property]({{< ref "application-graph" >}}) is used to configure relationships between from a service to another resource.
 
-Add a [`connection`]({{< ref "appmodel-concept" >}}) from `backend` to the `orders` state store. This declares the _intention_ from the `backend` container to communicate with the `statestore` resource
+Add a [`connection`]({{< ref "application-graph" >}}) from `backend` to the `orders` state store. This declares the _intention_ from the `backend` container to communicate with the `statestore` resource
 
 {{< rad file="snippets/connection.bicep" embed=true marker="//BACKEND" replace-key-container="//CONTAINER" replace-value-container="container: {...}" replace-key-extensions="//EXTENSIONS" replace-value-extensions="extensions: [...]" >}}
 

docs/content/getting-started/quickstarts/quickstart-dapr/dapr-microservices-overview/index.md

@@ -19,7 +19,7 @@ You can view and download the source code in the [samples repo](https://github.c
 
 ## Containers
 
-This Radius application will have two [containers]({{< ref appmodel-concept >}}):
+This Radius application will have two [containers]({{< ref application-graph>}}):
 
 - A frontend UI for users to place orders. Written with .NET Blazor.
 - A backend order processing microservice. Written in Node.JS.

docs/content/getting-started/quickstarts/quickstart-environment-variables/index.md

@@ -59,7 +59,7 @@ Next, add to `app.bicep` a [Mongo link]({{< ref links-resources >}}), leveraging
 
 ## Step 5: Connect to the Mongo Link
 
-Connections from a container to a link result in environment variables for connection information [automatically being set on the container]({{< ref "appmodel-concept#injected-values" >}}). Update your container definition to add a connection to the new Mongo link:
+Connections from a container to a link result in environment variables for connection information automatically being set on the container. Update your container definition to add a connection to the new Mongo link:
 
 {{< rad file="snippets/3-app.bicep" embed=true marker="//CONTAINER" >}}
 

docs/content/reference/faq.md

@@ -74,4 +74,4 @@ output values object = {
 
 ### Does Radius support all Azure resources?
 
-**Yes**. You can use any Azure resource type by modeling it in Bicep outside the `Applications.Core/applications` resource and defining a connection to the resource from a `Applications.Core/containers`. See the [connections page]({{< ref appmodel-concept >}}) for more details.
+**Yes**. You can use any Azure resource type by modeling it in Bicep outside the `Applications.Core/applications` resource and defining a connection to the resource from a `Applications.Core/containers`. See the [connections page]({{< ref application-graph>}}) for more details.