improve documentation

Author: eistrati

README.md

@@ -1,17 +1,42 @@
 # Terraform Demo using Google provider
 
 ## Login to Google Cloud
+
+Run the following command in terminal:
 ```shell
 gcloud auth login
 ```
 
-## Get Google Cloud values for ORG_ID and BILLING_ID
+> NOTE: If you don't have Google Cloud CLI, check out
+[installation guide](https://cloud.google.com/sdk/install)
+
+## Get Values from Your Google Cloud Account
+
+Run the following command in terminal:
 ```shell
 gcloud organizations list
+```
+
+Your output should be similar to the one below:
+```
+DISPLAY_NAME            ID  DIRECTORY_CUSTOMER_ID
+mydomain.com  123456789012  a1b2c3d4e
+```
+
+Run the following command in terminal:
+```shell
 gcloud beta billing accounts list
 ```
 
-## Setup Google Cloud ENV Variables
+Your output should be similar to the one below:
+```
+ACCOUNT_ID            NAME                OPEN  MASTER_ACCOUNT_ID
+123456-ABCDEF-ZYXWVU  My Billing Account  True
+```
+
+## Setup Environment Variables (Will Be Used Later)
+
+Manual Setup (set values in double quotes and run the following command in terminal):
 ```shell
 export GOOGLE_CLOUD_PROJECT=""            ## e.g. terrahub-123456
 export GOOGLE_APPLICATION_CREDENTIALS=""  ## e.g. ${HOME}/.config/gcloud/terraform.json
@@ -22,7 +47,18 @@ export IAM_NAME=""      ## e.g. terraform
 export IAM_DESC=""      ## e.g. terraform service account
 ```
 
+Automated Setup (run the following command in terminal):
+```shell
+export ORG_ID="$(gcloud organizations list --format=json | jq '.[0].name[14:]')"
+export BILLING_ID="$(gcloud beta billing accounts list --format=json | jq '.[0].name[16:]')"
+```
+
+> NOTE: If you don't have JQ CLI, check out
+[installation guide](https://stedolan.github.io/jq/download/)
+
 ## Create Google Cloud Project & Billing
+
+Run the following command in terminal:
 ```shell
 gcloud projects create ${GOOGLE_CLOUD_PROJECT} \
   --name="${PROJECT_NAME}" \
@@ -40,7 +76,13 @@ gcloud beta billing projects link ${GOOGLE_CLOUD_PROJECT} \
   --billing-account="${BILLING_ID}"
 ```
 
+Your output should be similar to the one below:
+```
+```
+
 ## Create Google Cloud IAM Service Account & Key
+
+Run the following command in terminal:
 ```shell
 gcloud iam service-accounts create ${IAM_NAME} \
   --display-name="${IAM_DESC}"
@@ -49,14 +91,26 @@ gcloud iam service-accounts keys create ${GOOGLE_APPLICATION_CREDENTIALS} \
   --iam-account="${IAM_NAME}@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com"
 ```
 
+Your output should be similar to the one below:
+```
+```
+
 ## Add IAM Policy Binding to Google Cloud Project
+
+Run the following command in terminal:
 ```shell
 gcloud projects add-iam-policy-binding ${GOOGLE_CLOUD_PROJECT} \
   --member="serviceAccount:${IAM_NAME}@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com" \
   --role="roles/editor"
 ```
 
+Your output should be similar to the one below:
+```
+```
+
 ## Add IAM Policy Binding to Google Cloud Organization
+
+Run the following command in terminal:
 ```shell
 gcloud organizations add-iam-policy-binding ${ORG_ID} \
   --member="serviceAccount:${IAM_NAME}@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com" \
@@ -67,14 +121,42 @@ gcloud organizations add-iam-policy-binding ${ORG_ID} \
   --role="roles/billing.user"
 ```
 
-## Create TerraHub Project
+Your output should be similar to the one below:
+```
+```
+
+## Create Terraform Configurations Using TerraHub
+
+Run the following commands in terminal:
+```shell
+terrahub --help | head -3
+```
+
+Your output should be similar to the one below:
+```
+Usage: terrahub [command] [options]
+
+terrahub@0.0.28 (built: 2018-10-11T12:33:57.775Z)
+```
+
+> NOTE: If you don't have TerraHub CLI, check out
+[installation guide](https://www.npmjs.com/package/terrahub)
+
+Run the following command in terminal:
 ```shell
 mkdir demo-terraform-google
 cd demo-terraform-google
 terrahub project -n demo-terraform-google
 ```
 
-## Create TerraHub Component
+Your output should be similar to the one below:
+```
+✅ Project successfully initialized
+```
+
+## Create TerraHub Components
+
+Run the following command in terminal:
 ```shell
 terrahub component -t google_project -n project
 terrahub component -t google_service_account -n service_account -o ../project
@@ -84,14 +166,50 @@ terrahub component -t google_project_iam_binding -n project_iam_policy_binding_s
 terrahub component -t google_project_iam_binding -n project_iam_policy_binding_compute_admin -o ../project_iam_member
 ```
 
-## Update TerraHub Component Config
+Your output should be similar to the one below:
+```
+✅ Done
+```
+
+## Visualize TerraHub Components
+
+Run the following command in terminal:
+```shell
+terrahub graph
+```
+
+Your output should be similar to the one below:
+```
+Project: demo-terraform-google
+ └─ project [path: ./project]
+    ├─ project_iam_member [path: ./project_iam_member]
+    │  ├─ project_iam_binding_compute_admin [path: ./project_iam_binding_compute_admin]
+    │  └─ project_iam_binding_storage_admin [path: ./project_iam_binding_storage_admin]
+    └─ service_account [path: ./service_account]
+       └─ service_account_key [path: ./service_account_key]
+```
+
+## Update Project Config
+
+Run the following command in terminal:
 ```shell
 terrahub configure -c terraform.var.google_org_id="${ORG_ID}"
 terrahub configure -c terraform.var.google_billing_account="${BILLING_ID}"
 terrahub configure -c terraform.var.google_project_id="${GOOGLE_CLOUD_PROJECT}"
 ```
 
-## Execute TerraHub Component
+Your output should be similar to the one below:
+```
+✅ Done
+```
+
+## Run TerraHub Automation
+
+Run the following command in terminal:
 ```shell
 terrahub run -a -y
 ```
+
+Your output should be similar to the one below:
+```
+```