doc update and tiltfile update

1. add bit more docs
2. tilt file update to prevent start up if .secret is missing.

Tiltfile

@@ -7,6 +7,11 @@ load('ext://uibutton', 'cmd_button')
 load('ext://helm_resource', 'helm_resource')
 load('./.tilt/terraform/Tiltfile', 'local_terraform_resource')
 load('./.tilt/utils/Tiltfile', 'check_env_set')
+
+# Check if the .secret file exists
+if not os.path.exists('.secret'):
+    fail('The .secret file is missing. Please copy .secret file from .secret.example and setup before running Tilt.')
+
 dotenv(fn='.secret')
 
 config.define_bool("enable_repo", True, 'create a new project for testing this app')

docs/contributing.md

@@ -69,13 +69,23 @@ To get started do the following:
 
 * Copy the `.secret.example` and set required values.
 
-    ```console
+    ```bash
+    cd ..
     cp .secret.example .secret
     ```
+  You will need to fill in either `GITLAB_TOKEN` or `GITLAB_TOKEN`  
+  If you are testing with GITHUB, please set the tile_config.json file to specify the vcs-type as the default is `gitlab`.  
+  The token you specify must have ability to get repositories, add/delete comment and webhooks.  
+    ```json
+    {
+      "vcs-type": "github"
+    }
+    ```
 
 * From the root directory of this repo:
 
-    ```console
+    ```bash
+    cd ..
     tilt up
     ```