Merge pull request #5 from digitalocean/readme-updates-20210109

Update README.md

Author: Kamal Nasser

README.md

@@ -1,44 +1,55 @@
-# Getting Started #
+# Getting Started
 
-These steps will get this sample application running for you using DigitalOcean.
+These steps will get this sample Vue.js application running for you using DigitalOcean App Platform.
 
-**Note: Following these steps will result in charges for the use of DigitalOcean services**
+**Note: Following these steps may result in charges for the use of DigitalOcean services**
 
 ## Requirements
 
 * You need a DigitalOcean account. If you don't already have one, you can sign up at https://cloud.digitalocean.com/registrations/new
 
-## Forking the Sample App Source Code
+## Deploying the App
 
-To use all the features of App Platform, you need to be running against your own copy of this application. To make a copy, click the Fork button above and follow the on-screen instructions. In this case, you'll be forking this repo as a starting point for your own app (see [Github documentation](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo) to learn more about forking repos.
+Click this button to deploy the app to the DigitalOcean App Platform. If you are not logged in, you will be prompted to log in with your DigitalOcean account.
 
-After forking the repo, you should now be viewing this README in your own github org (e.g. `https://github.com/<your-org>/sample-vuejs`)
+[![Deploy to DigitalOcean](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/apps/new?repo=https://github.com/digitalocean/sample-vuejs/tree/main)
 
-**Note:** You can skip forking this repo and select the "Vue.js" sample from the app creation page, however do notice that certain features will be disabled.
+Using this button disable the "Auto deploy changes on push" feature as you are using this repo directly. If you wish to try that feature, you will need to make your own copy of this repository.
 
-## Deploying the App ##
+To make a copy, click the Fork button above and follow the on-screen instructions. In this case, you'll be forking this repo as a starting point for your own app (see [GitHub documentation](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo) to learn more about forking repos.
 
-Click this button to deploy the app to the DigitalOcean App Platform.
+After forking the repo, you should now be viewing this README in your own github org (e.g. `https://github.com/<your-org>/sample-vuejs`). To deploy the new repo, visit https://cloud.digitalocean.com/apps and click "Create App" or "Launch Your App". Then, select the repository you created and be sure to select the `main` branch.
 
- [![Deploy to DO](https://mp-assets1.sfo2.digitaloceanspaces.com/deploy-to-do/do-btn-blue.svg)](https://cloud.digitalocean.com/apps/new?repo=https://github.com/digitalocean/sample-vuejs/tree/main)
- 
-## Making Changes to Your App ##
+After clicking the "Deploy to DigitalOcean" button or completing the instructions above to fork the repo, follow these steps:
 
-As long as you left the default Autodeploy option enabled when you first launched this app, you can now make code changes and see them automatically reflected in your live application. During these automatic deployments, your application will never pause or stop serving request because the App Platform offers zero-downtime deployments.
+1. Select which region you wish to deploy your app to and click Next. The closest region to you should be selected by default. All App Platform apps are routed through a global CDN so this will not affect your app performance, unless it needs to talk to external services.
+1. On the following screen, leave all the fields as they are and click Next.
+1. Confirm your Plan settings and how many containers you want to launch and click **Launch Basic/Pro App**.
+1. You should see a "Building..." progress indicator. And you can click "Deployments"→"Details" to see more details of the build.
+1. It can take a few minutes for the build to finish, but you can follow the progress by clicking the "Details" link in the top banner.
+1. Once the build completes successfully, click the "Live App" link in the header and you should see your running application in a new tab, displaying the home page.
 
-## Learn More ##
+## Making Changes to Your App
 
-You can learn more about the App Platform and how to manage and update your application at https://www.digitalocean.com/docs/apps/.
+If you followed the steps above to fork the repo and used your own copy when deploying the app, you can enjoy automatic deploys whenever changes are made to the repo. During these automatic deployments, your application will never pause or stop serving request because App Platform offers zero-downtime deployments.
 
+Here's an example code change you can make for this app:
 
-## Deleting the App #
+1. Edit `src/App.vue` and replace "Welcome to Your Vue App" with a different greeting
+1. Commit the change to the `main` branch. Normally it's a better practice to create a new branch for your change and then merge that branch to `main` after review, but for this demo you can commit to the `main` branch directly.
+1. Visit https://cloud.digitalocean.com/apps and navigate to your sample app.
+1. You should see a "Building..." progress indicator, just like when you first created the app.
+1. Once the build completes successfully, click the "Live App" link in the header and you should see your updated application running. You may need to force refresh the page in your browser (e.g. using Shift+Reload).
+
+## Learn More
+
+You can learn more about the App Platform and how to manage and update your application at https://www.digitalocean.com/docs/app-platform/.
+
+## Deleting the App
 
 When you no longer need this sample application running live, you can delete it by following these steps:
 1. Visit the Apps control panel at https://cloud.digitalocean.com/apps
-1. Navigate to the sample-vuejs app
+1. Navigate to the sample app
 1. Choose "Settings"->"Destroy"
 
-This will delete the app and destroy any underlying DigitalOcean resources
-
-**Note: If you don't delete your app, charges for the use of DigitalOcean services will continue to accrue.**
-
+**Note: If you don't delete your app, charges for the use of DigitalOcean services will continue to accrue.**