Add comments to refactored scripts

script/generate_views

@@ -1,5 +1,13 @@
 #!/bin/sh
 
+# Generate one view definition file per document type in '_stable' tables.
+#
+# If there are existing view definitions in the destination directory then those will be
+# kept instead.
+#
+# Run as:
+#   ./script/generate_views 'moz-fx-data-shared-prod:*_stable.*'
+
 cd "$(dirname "$0")/.."
 
-exec python3 -m bigquery_etl.generate_views "$@"
+exec python3 -m bigquery_etl.generate_views "$@"

script/publish_metadata

@@ -1,5 +1,7 @@
 #!/bin/sh
 
+# Update metadata of BigQuery tables and views.
+
 cd "$(dirname "$0")/.."
 
 exec python3 -m bigquery_etl.publish_metadata "$@"

script/publish_public_data_views

@@ -1,5 +1,11 @@
 #!/bin/sh
 
+# Generate and publish views for publicly available tables.
+# Generate view definitions for queries that are written to the
+# public data project and execute them. Views are published to
+# an internal project so that data is also accessible in private
+# datasets.
+
 cd "$(dirname "$0")/.."
 
 exec python3 -m bigquery_etl.public_data.publish_public_data_views "$@"