Merge pull request #140 from DefangLabs/linda-docs-5

jordanstephens · web-flow · commit 43df012f57b3 · 2024-12-05T17:23:00.000-05:00
Improved "features" page + minor fixes
diff --git a/docs/concepts/deployment-modes.md b/docs/concepts/deployment-modes.md
@@ -4,7 +4,7 @@ description: Defang provides three deployment modes which allow you to balance c
 sidebar_position: 501
 ---
 
-# Defang Deployment Modes
+# Deployment Modes
 
 Defang provides three deployment modes: development, staging, and production. These modes allow you to balance cost and resiliency according to your needs.
 
diff --git a/docs/faq/questions.md b/docs/faq/questions.md
@@ -27,7 +27,7 @@ import {Button, ButtonGroup, FormGroup, FormLabel} from "@mui/material"
 
 ### Do you plan to support other clouds?
 
-- While we currently support [AWS](/docs/providers/aws) for production, [GCP](/docs/providers/gcp) and [DigitalOcean](/docs/providers/digitalocean) are in preview with [Defang V1](blog/2024-12-04-launch-week). We plan to support other clouds, such as [Azure](/docs/providers/azure), in future releases.
+- While we currently support [AWS](/docs/providers/aws) for production, [GCP](/docs/providers/gcp) and [DigitalOcean](/docs/providers/digitalocean) are in preview with [Defang V1](/blog/2024-12-04-launch-week). We plan to support other clouds, such as [Azure](/docs/providers/azure), in future releases.
 
 ## Deployment Process
 
diff --git a/docs/intro/features.mdx b/docs/intro/features.mdx
@@ -6,17 +6,26 @@ description: Defang Features
 
 # Defang Features
 
-Defang provides a streamlined experience to develop, deploy, observe, and update your cloud applications. Defang includes the following features:
+Defang provides a streamlined experience to develop, deploy, and debug your cloud applications. Defang includes the following features:
 
-- Support for [various types of applications](/docs/intro/use-cases): Web services and APIs, mobile app backends, ML services, hosting LLMs, etc.
-- Support for your programming [language of choice](/docs/samples): Node.js, Python, Golang, or anything else you can package in a Dockerfile.
+### Wide Variety of Use Cases
+- Support for [various types of applications](/docs/intro/use-cases): web services and APIs, mobile app backends, ML services, hosting LLMs, etc...
+- Support for your programming [language of choice](/docs/samples): Node.js, Python, Golang, or anything else you can package in a Dockerfile
+
+### AI-Driven Features
 - Built-in AI agent to go [from natural language prompt to an outline project](/docs/tutorials/generate-new-code-using-ai)
 - Built-in AI agent to help you [debug your cloud applications](/docs/concepts/debug)
+
+### Container Friendly
 - Automated [Dockerfile builds](/docs/concepts/deployments)
 - Support for [pre-built Docker containers](/docs/tutorials/deploy-container-using-the-cli), from public or private image registries
 - Ability to express your project configuration using a [Docker Compose YAML](/docs/concepts/compose) file
-- Ability to manage [encrypted configuration values](/docs/concepts/configuration)
-- Pre-configured environments with built-in [security](/docs/concepts/security), [networking](/docs/concepts/networking), and [observability](/docs/concepts/observability)
+
+### Effortless Deployment
 - [One-command deployments](/docs/getting-started#install-the-defang-cli)
-- Support for [GPUs](/docs/concepts/resources)
+- Support for [GPUs](/docs/concepts/resources) and [managed storage options](/docs/concepts/managed-storage)
 - Support for Infra-as-Code via the [Defang Pulumi provider](/docs/concepts/pulumi)
+
+### Security and Configuration
+- Ability to manage [encrypted configuration values](/docs/concepts/configuration)
+- Pre-configured environments with built-in [security](/docs/concepts/security), [networking](/docs/concepts/networking), and [observability](/docs/concepts/observability)
diff --git a/docs/providers/_category_.json b/docs/providers/_category_.json
@@ -3,6 +3,6 @@
   "position": 400,
   "link": {
     "type": "generated-index",
-    "description": "Defang allows you to use your own cloud accounts to deploy your applications. Click on a link below to read documentation about specific providers. If no provider is specified, the Defang CLI will prompt you to select a provider interactively. The selected provider will be stored in the working directory of the project’s compose file and will be applied to all subsequent commands by default. You can also specify a preferred provider in the compose file by using `x-defang-provider` extension at the root level of the compose file.",
+    "description": "Defang allows you to use your own cloud accounts to deploy your applications. Click on a link below to read documentation about specific providers. If no provider is specified, the Defang CLI will prompt you to select a provider interactively. The selected provider will be stored in the working directory of the project’s compose file and will be applied to all subsequent commands by default. You can also specify a preferred provider in the compose file by using `x-defang-provider` extension at the root level of the compose file."
   }
 }
diff --git a/docs/providers/aws/aws.md b/docs/providers/aws/aws.md
@@ -4,7 +4,7 @@ description: Defang allows you to easily create and manage full, scalable applic
 sidebar_position: 000
 ---
 
-# AWS
+# Amazon Web Services (AWS)
 
 Why should you use Defang with AWS? Defang allows you to easily create and manage full, scalable applications with AWS. Defang aims to make it easier to deploy your services to the cloud. Don't waste your time learning the ins and outs of AWS, deciding which of the 200+ services to use, and then writing the infrastructure code to deploy your services, and making sure they are properly secured. Defang does all of that for you.
 
diff --git a/docs/tutorials/deploy-using-pulumi.mdx b/docs/tutorials/deploy-using-pulumi.mdx
@@ -23,7 +23,7 @@ mkdir project && cd project
 
 If you're familiar with Pulumi and/or are already logged in with the Pulumi CLI, you can skip the next step.
 
-If you are new to pulumi and/or don't have an account, you can "login" to the filesystem by running the following command:
+If you are new to Pulumi and/or don't have an account, you can "login" to the filesystem by running the following command:
 
 ```bash
 pulumi login file://./
diff --git a/docs/tutorials/use-your-own-domain-name.mdx b/docs/tutorials/use-your-own-domain-name.mdx
@@ -3,7 +3,7 @@ title: How to Use Your Own Domain
 sidebar_position: 600
 ---
 
-# How to Use Your Own Domain with AWS
+# How to Use Your Own Domain With AWS
 
 <iframe width="560" height="315" src="https://www.youtube.com/embed/n4RlMpsdTbs?si=_Ru6tobSbi9LT4Q1" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
 

Original file line number	Diff line number	Diff line change
`@@ -3,6 +3,6 @@`
`3`	`3`	`"position": 400,`
`4`	`4`	`"link": {`
`5`	`5`	`"type": "generated-index",`
`6`		- "description": "Defang allows you to use your own cloud accounts to deploy your applications. Click on a link below to read documentation about specific providers. If no provider is specified, the Defang CLI will prompt you to select a provider interactively. The selected provider will be stored in the working directory of the project’s compose file and will be applied to all subsequent commands by default. You can also specify a preferred provider in the compose file by using `x-defang-provider` extension at the root level of the compose file.",
	`6`	+ "description": "Defang allows you to use your own cloud accounts to deploy your applications. Click on a link below to read documentation about specific providers. If no provider is specified, the Defang CLI will prompt you to select a provider interactively. The selected provider will be stored in the working directory of the project’s compose file and will be applied to all subsequent commands by default. You can also specify a preferred provider in the compose file by using `x-defang-provider` extension at the root level of the compose file."
`7`	`7`	`}`
`8`	`8`	`}`