Add description and example usage to all shell scripts.

hack/jenkins/test-flake-chart/collect_data.sh

@@ -14,6 +14,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# Collects all test data manually, processes it, and uploads to GCS. This will
+# overwrite any existing data.
+# Example usage: ./collect_data.sh
+
 DIR=$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )
 
 # 1) "cat" together all summary files.

hack/jenkins/test-flake-chart/optimize_data.sh

@@ -14,6 +14,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# Takes a CSV file through stdin, compresses it and writes it to stdout.
+# Example usage: < data.csv ./optimize_data.sh > data_optimized.csv
+
 set -eu -o pipefail
 
 # Take input CSV. For each field, if it is the same as the previous row, replace it with an empty string.

hack/jenkins/test-flake-chart/process_data.sh

@@ -14,6 +14,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# Takes a series of gopogh summary jsons, and formats them into a CSV file with
+# a row for each test.
+# Example usage: cat gopogh_1.json gopogh_2.json gopogh_3.json | ./process_data.sh
+
 set -eu -o pipefail
 
 # Print header.

hack/jenkins/test-flake-chart/report_flakes.sh

@@ -14,6 +14,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# Creates a comment on the provided PR number, using the provided gopogh summary
+# to list out the flake rates of all failing tests.
+# Example usage: ./report_flakes.sh 11602 gopogh.json Docker_Linux
+
 set -eu -o pipefail
 
 if [ "$#" -ne 3 ]; then

hack/jenkins/test-flake-chart/upload_tests.sh

@@ -14,6 +14,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# Takes a gopogh summary, extracts test data as a CSV and appends to the
+# existing CSV data in the GCS bucket.
+# Example usage: ./jenkins_upload_tests.sh gopogh_summary.json
+
 set -eu -o pipefail
 
 if [ "$#" -ne 1 ]; then