Rethinking the "Getting started" doc

My primary goal here is to make this doc as short as possible while
still getting the user their first win using defang.

Author: jordanstephens

docs/getting-started/getting-started.md

@@ -8,66 +8,104 @@ description: Get started with Defang.
 # Getting Started
 
 
-### Install the CLI
+## Install the CLI
 
 First, you'll need to install the Defang CLI. The CLI is the primary way to interact with Defang. It allows you to create, deploy, and manage your services. You can find the [different installation methods here](./installing.md).
 
-### Authenticate with Defang
+## Generate a project
 
-To do pretty much anything with Defang, you'll need to authenticate with the platform. You can do this by running the following command:
-
-```bash
-defang login
+```
+$ defang generate nodejs-http
 ```
 
-:::info
-To learn more about how authentication works in defang, check out the [authenticating page](./authenticating.md).
-:::
-
-### Agree to the terms of service
+You should see the following prompt:
+```
+? What folder would you like to create the project in?
+```
+Type in the name of the folder you'd like to use for your new project and press ENTER.
 
-Before you can deploy code you should read and agree to our the terms of service. You can do this by running:
+I'll type `"welcome-to-defang"`. Now, you'll see the following output:
 
-```bash
-defang terms
+```
+? What folder would you like to create the project in? welcome-to-defang
+ * Fetching sample from the Defang repository...
+ * Writing files to disk...
+   - .github/
+   - .github/workflows/
+   - .github/workflows/deploy.yaml
+   - README.md
+   - app/
+   - app/Dockerfile
+   - app/main.js
+   - compose.yaml
+ * Code generated successfully in folder welcome-to-defang
+
+Check the files in your favorite editor.
+To deploy the service, do `cd welcome-to-defang` and
+
+  defang compose up
 ```
 
-### Build and Deploy Services
+Now, navigate to the folder you just created:
 
-Defang supports various ways of creating and deploying services to the cloud. The following tutorials dive into each one in more detail:
+```
+$ cd welcome-to-defang
+```
 
-1. [Deploy an outline using AI](../tutorials/generate-new-code-using-ai.mdx)
-2. [Build and deploy your code](../tutorials/deploy-code-compose.mdx)
-3. [Deploy existing containers](../tutorials/deploy-container-using-the-cli.mdx)
-4. [Deploy using Pulumi](../tutorials/deploy-using-pulumi.mdx)
+You can open the folder in your favorite editor and see the files that were generated for you:
+* The `app` folder contains the code for your service.
+* The `Dockerfile` is used to build the container image for your service.
+* The `compose.yaml` file is used to define the services you want to deploy.
 
+## Deploy to the playground
 
-### Monitor Services
+Go back to your shell and type the following:
 
-By default, all the output (stdout and stderr) from your app is logged. You can view these logs in real-time. You can view logs for all your services, one service, or even one specific deployment of a service.
+```
+$ defang up
+```
 
-- From the CLI:
-    
-    ```tsx
-    defang tail --name service1
-    ```
-    
-- From the Defang Portal:
-    
-    [https://portal.defang.dev/](https://portal.defang.dev/) 
+If you have not used defang before, you'll be prompted to log in.
 
+```
+ ! Please log in to continue.
+Please visit http://127.0.0.1:49154 and log in. (Right click the URL or press ENTER to open browser)
+```
 
 :::info
-* To learn more about observability in Defang, check out the [observability page](../concepts/observability.md).
-* Note that the Defang Portal only displays services deployed to Defang Playground.
+To learn more about how authentication works in defang, check out the [authenticating page](./authenticating.md).
 :::
-    
 
-### Update Services
+You'll see the following output:
 
-To update your app (for example, updating the base image of your container, or making changes to your code) you can run the `defang compose up` command and it will build and deploy a new version with zero downtime. Your current version of the service will keep running and handling traffic while the new version is being built and deployed. Only after the new version passes the health checks and accepts traffic will the older version be stopped.
+```
+ * Compressing build context for app at /Users/me/welcome-to-defang/app
+ * Uploading build context for app
+ * Deploying service app
+ * Monitor your services' status in the defang portal
+   - https://portal.defang.dev/service/app
+ * Tailing logs for deployment ID lurnaezbvoxp ; press Ctrl+C to detach:
+ * Press V to toggle verbose mode
+2024-09-18T08:17:16.119532-07:00 cd Update started for stack me-prod1
+2024-09-18T08:18:13.272207-07:00 cd Update succeeded in 57.183437801s ; provisioning...
+2024-09-18T08:18:51.767417-07:00 app Server running at http://127.0.0.1:3000/
+```
 
-:::info
-If you are using [compose files](../concepts/compose.md) to define your services, you can add/remove services, make changes to code, etc. When you run `defang compose up`, the update will be diffed against the current state and any necessary changes will be applied to make the current state match the desired state.
-:::
+Now we can go to [https://portal.defang.dev/service/app](https://portal.defang.dev/service/app) to see our service listed in the defang portal.
+
+Click on the arrow next to the service name to see your service running in the browser.
+
+## Next Steps
+
+Congratulations! You've successfully deployed your first service with Defang. Now, where do you go from here?
+
+Defang supports various ways of creating and deploying services to the cloud. The following tutorials dive into each one in more detail:
+
+1. [Update the code and redeploy](/docs/getting-started/update.mdx)
+2. [Monitor your services](/docs/getting-started/update.mdx)
+3. [Deploy an outline using AI](../tutorials/generate-new-code-using-ai.mdx)
+4. [Build and deploy your code](../tutorials/deploy-code-compose.mdx)
+5. [Deploy existing containers](../tutorials/deploy-container-using-the-cli.mdx)
+6. [Deploy using Pulumi](../tutorials/deploy-using-pulumi.mdx)
 
+Choose the direction that seems the most interesting. If you have any questions, join the [Defang Discord](https://discord.gg/defang) and we'll be happy to help you out.