From 2c9208171b15ca03b3953437e6fdf7c6de9fe9b1 Mon Sep 17 00:00:00 2001
From: Wing-Kam Wong <wingkwong.code@gmail.com>
Date: Tue, 5 Apr 2022 13:17:37 +0800
Subject: [PATCH] docs: revise Upgrading

Signed-off-by: Wing-Kam Wong <wingkwong.code@gmail.com>
---
 .../content/en/getting-started/upgrading.md   | 55 ++++++++++---------
 1 file changed, 30 insertions(+), 25 deletions(-)

diff --git a/packages/noco-docs/content/en/getting-started/upgrading.md b/packages/noco-docs/content/en/getting-started/upgrading.md
index 618895d66f..485b8a8b6f 100644
--- a/packages/noco-docs/content/en/getting-started/upgrading.md
+++ b/packages/noco-docs/content/en/getting-started/upgrading.md
@@ -8,63 +8,68 @@ link: https://codesandbox.io/embed/vigorous-firefly-80kq5?hidenavigation=1&theme
 ---
 
 ## Docker
-### Find, stop & delete nocodb docker container 
-```
-docker ps
 
-docker stop "YOUR_CONTAINER_ID"
+### Find, Stop & Delete NocoDB Docker Container 
 
-docker rm "YOUR_CONTAINER_ID"
+```bash
+# find NocoDB container ID
+docker ps
+# stop NocoDB container
+docker stop <YOUR_CONTAINER_ID>
+# delete NocoDB container
+docker rm <YOUR_CONTAINER_ID>
 ```
 
-### Find & remove nocodb docker image
-```
-docker images
+### Find & Remove NocoDB Docker Image
 
-docker rmi YOUR_IMAGE_ID
+```bash
+# find NocoDB image
+docker images
+# delete NocoDB image
+docker rmi <YOUR_IMAGE_ID>
 ```
 
-### Pull the latest nocodb image with same environment variables
-```
+### Pull the latest NocoDB image with same environment variables
+
+```bash
 docker run -d -p 8080:8080 \
-    -e NC_DB="YOUR_NC_DB_URL" \
-    -e NC_AUTH_JWT_SECRET="YOUR_NC_AUTH_JWT_SECRET_IF_GIVEN" \
+    -e NC_DB="<YOUR_NC_DB_URL>" \
+    -e NC_AUTH_JWT_SECRET="<YOUR_NC_AUTH_JWT_SECRET_IF_GIVEN>" \
     nocodb/nocodb:latest
 ```
 
-Updating nocodb docker container is similar to updating [any other docker container](https://www.whitesourcesoftware.com/free-developer-tools/blog/update-docker-images/).
+Updating nocodb docker container is similar to updating [any other docker containers](https://www.whitesourcesoftware.com/free-developer-tools/blog/update-docker-images/).
  
-### Example docker upgrade
+### Example: Docker Upgrade
 ![Screen Shot 2021-09-16 at 09 23 07](https://user-images.githubusercontent.com/5435402/133578984-53c6b96b-3e8b-4a96-b6c2-36f3c09ffdde.png)
 
-
-
 ## Node 
 
 Updating docker container is similar to updating a npm package.
 
 From your root folder 
 
-#### Uninstall nocodb package
+#### Uninstall NocoDB package
+
 ```bash
 npm uninstall nocodb
 ```
-#### Install nocodb package
+#### Install NocoDB package
+
 ```bash
 npm install --save nocodb
 ```
 
-
 ## Heroku
 
 ### Using the Heroku CLI login
 
-```
+```bash
 heroku container:login
 docker pull nocodb/nocodb:latest
-docker tag nocodb/nocodb:latest registry.heroku.com/<Heroku App Name>/web
-docker push registry.heroku.com/<Heroku App Name>/web
-heroku container:release -a <Heroku App Name> web
+docker tag nocodb/nocodb:latest registry.heroku.com/<HEROKU_APP_NAME>/web
+docker push registry.heroku.com/<HEROKU_APP_NAME>/web
+heroku container:release -a <HEROKU_APP_NAME> web
 ```
 
 #### On Apple M1 Chipset 
@@ -73,7 +78,7 @@ heroku container:release -a <Heroku App Name> web
 > 
 > ```export DOCKER_DEFAULT_PLATFORM=linux/amd64```
 >
-> More details [here](https://medium.com/geekculture/from-apple-silicon-to-heroku-docker-registry-without-swearing-36a2f59b30a3). 
+> More details can be found [here](https://medium.com/geekculture/from-apple-silicon-to-heroku-docker-registry-without-swearing-36a2f59b30a3). 
 
 ### Using GitHub