Add buildDocs function for build verification.

Author: daspecster

scripts/update_json_docs.sh

@@ -2,12 +2,15 @@
 
 set -e
 
-function pushDocs () {
 
+function buildDocs () {
   echo "Building JSON documentation..."
   PYTHONPATH=_testing python scripts/generate_json_docs.py --tag ${1}
   echo "Done building JSON documentation."
+}
+
 
+function pushDocs () {
   echo "Deploying JSON documentation..."
   if [[ ! -d "ghpages" ]]; then
       git submodule add -f -b gh-pages https://${GH_OAUTH_TOKEN}@github.com/${GH_OWNER}/${GH_PROJECT_NAME} ghpages
@@ -41,13 +44,18 @@ function cleanSubmodule () {
     echo "Done cleaning up!"
 }
 
+# Run this to verifiy that the docs build successfully.
+buildDocs $TRAVIS_BRANCH
+
 if [ "${TRAVIS_BRANCH}" == "master" ] && [ "${TRAVIS_PULL_REQUEST}" == "false" ]; then
+    buildDocs $TRAVIS_BRANCH
   pushDocs $TRAVIS_BRANCH
   cleanSubmodule
   echo "Done pushing docsite. See: https://googlecloudplatform.github.io/gcloud-python/"
 fi
 
 if [[ ! -z $TRAVIS_TAG ]]; then
+  buildDocs $TRAVIS_TAG
   pushDocs $TRAVIS_TAG
   cleanSubmodule
   echo "Done pushing docsite. See: https://googlecloudplatform.github.io/gcloud-python/"