Update dev guide and generated protos.

Author: michelle192837

web/README.md

@@ -6,12 +6,18 @@ Testgrid frontend code uses Lit elements and is written in Typescript. `tsconfig
 More info about Lit and Typescript can be found in [Lit docs](https://lit.dev/) and [TS docs](https://www.typescriptlang.org/) respectively.
 
 ## Development
-Local development is done with the help of [Web Dev Server](https://modern-web.dev/docs/dev-server/overview/). Web dev server configurations are defined in `web-dev-server-{env}.config.mjs` file. Depending on the config, frontend will render from the data from either fake or prod API. 
+Local development is done with the help of [Web Dev Server](https://modern-web.dev/docs/dev-server/overview/). Web dev server configurations are defined in `web-dev-server-{env}.config.mjs` file. Depending on the config, frontend will render from the data from either fake or prod API.
 
-To see fake data, run `npm run start:local`. To see prod data, run `npm run start:k8s`. More info in the [Scripts](#scripts) section below.
+To develop locally:
+- Run `npm install`, then:
+  - To see fake data, run `npm run start:local`
+  - To see prod data, run `npm run start:k8s`
+
+More info in the [Scripts](#scripts) section below.
+
+TIP: If you hit unexpected errors, try running `rm -rf node_modules/`, then `npm install` to refresh dependencies.
 
 ## Testing
-Testing relies on [Web Test Runner](https://modern-web.dev/docs/test-runner/overview/) with the configuration defined in `web-test-runner.config.mjs`. Testing is currently happening across the fake data provided by `json-server`.
 
 To run the tests, run `npm run test`. More info in the [Scripts](#scripts) section below.
 
@@ -28,7 +34,15 @@ Most scripts are in `npm run` commands.
 
 ## Pulling from upstream
 
-Upstream proto definitions can be generated by running `pb/bump-protos.sh`
+To generate or update the proto definitions:
+
+- Checkout a local copy of https://github.com/GoogleCloudPlatform/testgrid, ex. `gh repo clone GoogleCloudPlatform/testgrid $HOME/gcp-testgrid`
+- Run
+  ```
+  # Path to local GCP/testgrid repo, `$HOME/gcp-testgrid`
+  TGREPO={{local GCP/testgrid repo}}
+  bump-protos.sh "$TGREPO"
+  ```
 
 ## Configs and files
 - Frontend code is located in `src` dir.
@@ -38,4 +52,4 @@ Upstream proto definitions can be generated by running `pb/bump-protos.sh`
 - `tsconfig.json` defines how and where will the .ts files compile.
 - `web-dev-server-*.config.mjs` defines configuration parameters for the web dev server.
 - `web-test-runner.config.mjs` defined configuration parameters for the web test runner.
-- `rollup.config.js` defines how the code will be built and bundled.
+- `rollup.config.js` defines how the code will be built and bundled.

web/bump-protos.sh

@@ -17,16 +17,27 @@ set -o errexit
 set -o nounset
 set -o pipefail
 
-WORKDIR="${HOME}/github/testgrid" # The root directory of your repository
+if [ "$#" -lt 1 ]
+then
+  echo "Usage: $0 [path to local GCP/testgrid repo]"
+  exit 1
+fi
+
+# The location of your local https://github.com/GoogleCloudPlatform/testgrid repo, where the proto files live.
+TESTGRID_REPO=$1
+
+WORKDIR="$(git rev-parse --show-toplevel)" # The root directory of your repository
 PROTO_DEST="${WORKDIR}/web/src/gen"
 
+echo "Generating protos from source $TESTGRID_REPO to destination $PROTO_DEST..."
+
 cd "${WORKDIR}/web"
 
 # See https://github.com/timostamm/protobuf-ts/blob/master/MANUAL.md
-npx protoc --ts_out ${PROTO_DEST} --proto_path ${WORKDIR} --ts_opt long_type_string \
-  ${WORKDIR}/pb/custom_evaluator/custom_evaluator.proto \
-  ${WORKDIR}/pb/state/state.proto \
-  ${WORKDIR}/pb/summary/summary.proto \
-  ${WORKDIR}/pb/config/config.proto \
-  ${WORKDIR}/pb/test_status/test_status.proto \
-  ${WORKDIR}/pb/api/v1/data.proto
+npx protoc --ts_out ${PROTO_DEST} --proto_path ${TESTGRID_REPO} --ts_opt long_type_string \
+  ${TESTGRID_REPO}/pb/custom_evaluator/custom_evaluator.proto \
+  ${TESTGRID_REPO}/pb/state/state.proto \
+  ${TESTGRID_REPO}/pb/summary/summary.proto \
+  ${TESTGRID_REPO}/pb/config/config.proto \
+  ${TESTGRID_REPO}/pb/test_status/test_status.proto \
+  ${TESTGRID_REPO}/pb/api/v1/data.proto