tools/issue-tracking.md - Update guidance on Gitlab labels
Created by: totten
Before: The documentation explains ~5 common labels. Gitlab actually has ~50 labels.
After: The documentation explains ~3 important labels and ~4 prefixes. Each prefix is given with a definition and example, and there are links to the full lists.
Comment: The link goes to https://lab.civicrm.org/dev/core/-/labels
though arguably https://lab.civicrm.org/groups/dev/-/labels might be better.
However, there a dozen or so labels which (rightly or wrongly) only show up
in dev/core, so dev/core gives the more comprehensive listing.
--
@eileenmcnaughton @bjendres @jaapjansma - This is the corresponding docs update for that table that I drafted on MM. Note that there is one stylistic change - when something has a component name ("CiviMail", "CiviMember"), it uses that name (comp:CiviMail instead of comp:mailings). It's kind of a toss-up on aesthetic grounds, but I think this label is more forgiving when the user does data-entry:
| If the user types... | and if the label is... | then the user gets the right label |
|---|---|---|
| "mail" | comp:mailings |
Yes, matches |
| "CiviMail" | comp:mailings |
No |
| "mail" | comp:CiviMail |
Yes, matches |
| "CiviMail" | comp:CiviMail |
Yes, matches |