Merge pull request #547 from gregfenton/gregfenton-patch-1

Clarifying docs for non-interactive use of `fs-bq-import-collection`

Author: jhuleatt

firestore-bigquery-export/guides/IMPORT_EXISTING_DOCUMENTS.md

@@ -27,7 +27,7 @@ The import script uses several values from your installation of the extension:
 
 - `${PROJECT_ID}`: the project ID for the Firebase project in which you installed the extension
 - `${COLLECTION_PATH}`: the collection path that you specified during extension installation
-- `${COLLECTION_GROUP_QUERY}`: Confirmation you would like to use a `collectionGroup` query. Reverts to a `collection` query if the value is `false`.
+- `${COLLECTION_GROUP_QUERY}`: uses a `collectionGroup` query if this value is `"true"`. For any other value, a `collection` query is used.
 - `${DATASET_ID}`: the ID that you specified for your dataset during extension installation
 
 Run the import script using [`npx` (the Node Package Runner)](https://www.npmjs.com/package/npx) via `npm` (the Node Package Manager).
@@ -47,12 +47,14 @@ Run the import script using [`npx` (the Node Package Runner)](https://www.npmjs.
 
     Alternatively, you can [create and use a service account](https://cloud.google.com/docs/authentication/production#obtaining_and_providing_service_account_credentials_manually). This service account must be assigned a role that grants the `bigquery.datasets.create` [permission](https://cloud.google.com/bigquery/docs/access-control#bq-permissions).
 
-1.  Run the import script via `npx` by running the following command:
+1.  Run the import script interactively via `npx` by running the following command:
 
     ```
     npx @firebaseextensions/fs-bq-import-collection
     ```
 
+    **Note**: The script can be run non-interactively. To see its usage, run the above command with `--help`.
+
 1.  When prompted, enter the Cloud Firestore collection path that you specified during extension installation, `${COLLECTION_PATH}`.
 
 1.  _(Optional)_ You can pause and resume the import at any time:

firestore-bigquery-export/scripts/import/src/index.ts

@@ -113,8 +113,8 @@ program
     "The path of the the Cloud Firestore Collection to import from. (This may, or may not, be the same Collection for which you plan to mirror changes.)"
   )
   .option(
-    "-q, --query-collection-group <query-collection-group>",
-    "A boolean value indicating whether you'd prefer a collection group query (true) or a collection query (false)"
+    "-q, --query-collection-group [true|false]",
+    "Use 'true' for a collection group query, otherwise a collection query is performed."
   )
   .option(
     "-d, --dataset <dataset>",