chore: docs changing "master" to "main" (#538)

* chore: changing "master" to "main" for non-Jenkins portion of
instructions. Issue 486

* chore: removed trailing whitespace

* chore: reverting change so it can be fixed with code change

Author: mark1000

1-org/README.md

@@ -131,7 +131,10 @@ Run `terraform output cloudbuild_project_id` in the `0-bootstrap` folder to see
 1. Clone the repo.
    ```
    gcloud source repos clone gcp-org --project=YOUR_CLOUD_BUILD_PROJECT_ID
+
    ```
+   The message `warning: You appear to have cloned an empty repository.` is
+   normal and can be ignored.
 1. Navigate into the repo and change to a non-production branch. All subsequent
    steps assume you are running them from the gcp-environments directory. If
    you run them from another directory, adjust your copy paths accordingly.

2-environments/README.md

@@ -73,7 +73,7 @@ commands. The `-T` flag is needed for Linux, but causes problems for MacOS.
    ```
    gcloud source repos clone gcp-environments --project=YOUR_CLOUD_BUILD_PROJECT_ID
    ```
-1. Navigate into the repo and change to the non-master branch. All subsequent
+1. Navigate into the repo and change to the non-main branch. All subsequent
    steps assume you are running them from the gcp-environments directory. If
    you run them from another directory, adjust your copy paths accordingly.
 

3-networks/README.md

@@ -120,7 +120,7 @@ If you are not able to use Dedicated or Partner Interconnect, you can also use a
    ```
    gcloud source repos clone gcp-networks --project=YOUR_CLOUD_BUILD_PROJECT_ID
    ```
-1. Change to the freshly cloned repo and change to non-master branch.
+1. Change to the freshly cloned repo and change to non-main branch.
    ```
    git checkout -b plan
    ```

4-projects/README.md

@@ -117,7 +117,7 @@ commands. The `-T` flag is needed for Linux, but causes problems for MacOS.
    ```
    gcloud source repos clone gcp-projects --project=YOUR_CLOUD_BUILD_PROJECT_ID
    ```
-1. Change freshly cloned repo and change to non-master branch.
+1. Change freshly cloned repo and change to non-main branch.
    ```
    git checkout -b plan
    ```

5-app-infra/README.md

@@ -120,7 +120,7 @@ commands. The `-T` flag is needed for Linux, but causes problems for MacOS.
    ```
    cd bu1-example-app
    ```
-1. Change freshly cloned repo and change to non-master branch.
+1. Change freshly cloned repo and change to non-main branch.
    ```
    git checkout -b plan
    ```

docs/TROUBLESHOOTING.md

@@ -17,6 +17,7 @@ See [GLOSSARY.md](./GLOSSARY.md).
 ## Common issues
 
 - [Project quota exceeded](#project-quota-exceeded)
+- [Default branch setting](#default-branch-setting)
 - [Terraform State Snapshot lock](#terraform-state-snapshot-lock)
 - [Application authenticated using end user credentials](#application-authenticated-using-end-user-credentials)
 - [Cannot assign requested address error in Cloud Shell](#cannot-assign-requested-address-error-in-cloud-shell)
@@ -46,6 +47,30 @@ use the email address of `terraform_service_account` that is created by the Terr
 
 - If you see other quota errors, see the [Quota documentation](https://cloud.google.com/docs/quota).
 
+### Default branch setting
+
+**Error message:**
+
+```
+error: src refspec master does not match any
+```
+**Cause:**
+
+This could be due to init.defaultBranch being set to something other than
+`main`.
+
+**Solution:**
+
+1. Determine your default branch:
+   ```
+   git config init.defaultBranch
+   ```
+   Outputs `main` if you are in the main branch.
+1. If your default branch is not set to `main`, set it:
+   ```
+   git config --global init.defaultBranch main
+   ```
+
 ### Terraform State Snapshot lock
 
 **Error message:**