feat: squash: more updates

Author: kdmccormick

migrate/labels.yml

@@ -1,53 +1,66 @@
 # Repository labels to be synced across the entire org.
 # Every item must have a name, color, and description.
+
 # Notes:
 # * Repositories may define their own labels as long as they don't
-#   conflict with what's listed here.
+#   conflict with what's listed here. If it turns out a repository-specific
+#   label would be useful to have in the entire organization, we can always add
+#   it here post facto.
+# * We have added these based on need. They are not all-encompassing. If something
+#   seems missing, feel free to open a PR.
 # * Whenever a repo has a matching label, that label will be updated. If there
 #   is no matching label, the label will be created anew. "Matching" is determined
 #   by comparing the label's lowercased name, with all puncutation, emoji, and special
 #   chars removed.
 # * For picking hex colors, you might use: https://www.htmlcolor-picker.com/
+#   Describe your color with a comment so it's easier to review.
+
 
-### COMMUNITY LABELS
+### LABELS INDICATING HOW ISSUES CAN BE ENAGAGED WITH.
 
 - name: "good first issue"
   color: "42dd35"  # friendly lime green
   description: "A good task for a newcomer to start with"
 
 - name: "help wanted"
   color: "54976d"  # fenway green
-  description: "Ready to be picke up by anyone in the community"
+  description: "Ready to be picked up by anyone in the community"
 
-- name: "DEPR"
-  color: "3c3cc3"  # indigo-blue
-  description: "Proposal for depreaction & removal per OEP-21"
 
-
-### KINDS OF WORK
+### LABELS INDICATING BROAD THEMES OF WORK.
+### MORE THAN ONE OF THESE MAY APPLY AT A TIME.
 
 - name: "maintenance"
   color: "ff9125"  # construction orange
-  description: "Work that must be done for platform health"
+  description: "Relates to platform health and/or routine upkeep"
 
-- name: "discovery"
-  color: "d876e3"  # a curious shade of lavendar
-  description: "Pre-work to determine if an idea is feasible"
-
-- name: "bug"
-  color: "d93f0b"  # scarlet red
-  description: "Something isn't working"
+- name: "security"
+  color: "f0d165"  # caution yellow
+  description: "Relates to improving to the security posture of the platform"
 
 - name: "enhancement"
-  color: "a2eeef"  # refreshing light teal
-  description: "Update or improvement to an existing feature"
+  color: "a2eeef"  # electric blue!
+  description: "Relates to new features or improvements to existing features"
 
-- name: "feature"
-  color: "05d1dc"  # teal for real
-  description: "Addition of new functionality"
+- name: "documentation"
+  color: "0052cc"  # royal blue
+  description: "Relates to documentation improvements"
 
 
-### SCOPES OF WORK
+### LABELS INDICATING THE SCOPE OR FUNCTION OF THE ISSUE.
+### AT MOST ONE OF THESE SHOULD BE USED AT A TIME.
+
+- name: "depr"
+  color: "3c3cc3"  # indigo-blue
+  description: "Proposal for deprecation & removal per OEP-21"
+
+- name: "bug"
+  color: "d93f0b"  # scarlet red...
+  description: "Report of or fix for something that isn't working as intended"
+
+- name: "discovery"
+  color: "d876e3"  # a curious shade of lavendar
+  description: "Pre-work to determine if an idea is feasible"
 
 - name: "epic"
   color: "7e027e"  # epic violet
@@ -58,7 +71,7 @@
   description: "Huge unit of work, consisting of multiple epics"
 
 
-### ISSUE OUTCOMES
+### LABELS INDICATING ISSUE OUTCOMES.
 
 - name: "wontfix"
   color: "ffffff"  # white
@@ -69,7 +82,8 @@
   description: "This issue or pull request already exists elsewhere"
 
 
-### PR TRIAGE WORKFLOW
+### LABELS USED IN THE OPEN EDX CONTRIBUTION WORKFLOW.
+### PLEASE CONSULT WITH OPEN EDX PROJECT MANAGMENT BEFORE CHANGING THESE.
 
 - name: "waiting on author"
   color: "bfd6f6"  # baby blue
@@ -79,7 +93,7 @@
   color: "cc950a"  # clay-ish brown
   description: "PR author has been unresponsive for several months"
 
-- name: "closed-inactivity"
+- name: "closed inactivity"
   color: "dbcd00"  # gold
   description: "PR was closed because the author abandoned it"
 
@@ -91,7 +105,7 @@
   color: "000000"  # black
   description: "PR is Core Contributor with rights in this repository (manually added)"
 
-- name: "open-source-contribution"
+- name: "open source contribution"
   color: "f0f0f0"  # light grey
   description: "PR author is not from Axim or 2U"