docs: clarifying these scripts are for imports

Author: joshjohanning

gh-cli/README.md

@@ -720,7 +720,7 @@ Gets a list of members (via GraphQL) and their role in an organization
 
 ### get-organization-migrations-summary.sh
 
-Gets a summary of all migrations against a given organization with [GitHub Enterprise Importer](https://docs.github.com/en/migrations/using-github-enterprise-importer)
+Gets a summary of all migrations (imports) against a given organization with [GitHub Enterprise Importer](https://docs.github.com/en/migrations/using-github-enterprise-importer)
 
 example:
 
@@ -739,7 +739,7 @@ Total                10
 
 ### get-organization-migrations-tsv.sh
 
-Gets a TSV with a list of migrations performed (or being performed) on a given organization with [GitHub Enterprise Importer](https://docs.github.com/en/migrations/using-github-enterprise-importer)
+Gets a TSV with a list of migrations (imports) performed (or being performed) on a given organization with [GitHub Enterprise Importer](https://docs.github.com/en/migrations/using-github-enterprise-importer)
 
 It contains the following data:
 

gh-cli/get-organization-migrations-summary.sh

@@ -1,5 +1,10 @@
 #!/bin/bash
 
+# summarizes the most recent migration imports for a given organization
+
+# gh cli's token needs to be able to admin org - run this if it fails
+# gh auth refresh -h github.com -s admin:org
+
 if [ $# -lt "1" ]; then
     echo "Usage: $0 <organization>"
     exit 1
@@ -9,7 +14,7 @@ organization=$1
 
 if ! response=$(gh api graphql -f org="$organization" -f query='query ($org: String!) {
   organization(login: $org) {
-   queued : repositoryMigrations(state: QUEUED) { totalCount	}
+   queued : repositoryMigrations(state: QUEUED) {totalCount}
    notstarted: repositoryMigrations(state: NOT_STARTED) {totalCount}
    inprogress: repositoryMigrations(state: IN_PROGRESS) {totalCount}
    suceeded: repositoryMigrations(state: SUCCEEDED) {totalCount}

gh-cli/get-organization-migrations-tsv.sh

@@ -1,5 +1,10 @@
 #!/bin/bash
 
+# gets a list of organization migration imports in tsv format
+
+# gh cli's token needs to be able to admin org - run this if it fails
+# gh auth refresh -h github.com -s admin:org
+
 if [ $# -lt "1" ]; then
     echo "Usage: $0 <organization> [max migrations]"
     echo "[max migrations] is optional max value is 100. Use if you do not want to get all migrations"