Welcome to mirror list, hosted at ThFree Co, Russian Federation.

gitlab.com/gitlab-org/gitlab-docs.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSuzanne Selhorn <sselhorn@gitlab.com>2023-01-04 01:19:49 +0300
committerSarah German <sgerman@gitlab.com>2023-01-04 01:19:49 +0300
commit94d46132fe049af8d778529d22522708d5b54ec6 (patch)
treef075f2c7d288e8165b41b3ebc355fb9251d9065a /scripts/create_issues.js
parent336f7c30035c6979ac177a1d459db29146f91737 (diff)
Updating description to mention the template
Diffstat (limited to 'scripts/create_issues.js')
-rwxr-xr-xscripts/create_issues.js21
1 files changed, 18 insertions, 3 deletions
diff --git a/scripts/create_issues.js b/scripts/create_issues.js
index 0d7ce3e2..30246345 100755
--- a/scripts/create_issues.js
+++ b/scripts/create_issues.js
@@ -3,8 +3,20 @@
/**
* @file create_issues.js
*
- * Issues created by this script are given hackathon-specific labels
- * and populated with descriptions of Vale warnings from the given CSV.
+ * This script takes a CSV file of Vale issues and uses the
+ * Doc_cleanup.md template to create issues for contributors.
+ *
+ * An issue is created for each markdown file in the CSV. For example:
+ * https://gitlab.com/gitlab-org/gitlab/-/issues/386506
+ *
+ * The Doc_cleanup.md template is here:
+ * https://gitlab.com/gitlab-org/gitlab/-/blob/master/.gitlab/issue_templates/Doc_cleanup.md
+ * This template has labels associated with it.
+ * These labels are assigned to the issues.
+ *
+ * An example sheet (that you can export to CSV file) is here:
+ * https://docs.google.com/spreadsheets/d/1ukGT-1H-Qvik9GwCU1n0oAH9vofvkKvlL3ga8PaCXjw/edit?usp=sharing
+ *
*
* Prerequistes:
* 1. Install glab: https://gitlab.com/gitlab-org/cli
@@ -12,7 +24,7 @@
* 3. Run "yarn" in gitlab-docs to ensure node.js dependencies are up-to-date.
*
* Use the script:
- * 1. Create a spreadsheet of Vale issues using this template. Do not remove or change the headers.
+ * 1. Create a spreadsheet of Vale issues by using this template. Do not remove or change the headers.
* https://docs.google.com/spreadsheets/d/1ukGT-1H-Qvik9GwCU1n0oAH9vofvkKvlL3ga8PaCXjw/edit?usp=sharing
* 2. Export the spreadsheet to a CSV, and remove spaces from the filename.
* 3. The script requires three variables to run:
@@ -21,6 +33,9 @@
* - MILESTONE: Milestone for the issue (ID or name)
* 4. Prepend the above variables when calling the script, like this:
* CSV_PATH="Sheet1.csv" REPO="https://gitlab.com/sselhorn/test-project" MILESTONE="15.9" ./scripts/create_issues.js
+ *
+ * The Backlog milestone in the main gitlab repo is 490705.
+ *
* 5. Run the command from the root of the gitlab-docs project.
*/