Syndesis: New label hierachy

Created on 16 Oct 2017  路  8Comments  路  Source: syndesisio/syndesis

Before we move our issues and PRs we should agree on our label hierarchy, which also reflects the various backend.

I'd like to have something hierarchical like K8s uses it, e.g. backend/bug, ui/text-change, .... which are coloured coded, too (e.g. all backend labels are in a green tone, ....)

For the first level, I suggest:

  • ui
  • rest
  • ux
  • doc
  • qe
  • connector
  • template

and then as second level:

  • feat
  • bug
  • ... ?

plus some global tags like

  • blocker
  • wip
  • poc
  • ...

wdyt ?

Most helpful comment

Ok, I came up for now with the following label hierarchy, and mapping from old projects:

auth:
  user: "syndesis-bot"
  token: "...."

target: "syndesisio/issue-import-test"

labels:
  approved: "0ffa16"
  Epic: "364294"

  module/rest: "9d653d"
  module/ui: "dce6f0"
  module/deploy: "ab947d"
  module/runtime: "657c9a"
  module/s2i: "2b313c"
  module/connectors: "b39d9e"
  module/tests: "91ac83"
  module/uxd: "fdc5d8"
  module/verifier: "c6d74b"
  module/project: "e8a824"

  ext/atlasmap: "edb080"
  ext/camel: "c56b37"
  ext/docs: "f9d647"
  ext/qe: "91ac83"

  status/wip: "f5c73f"
  status/blocked: "ad0009"

  notif/doc-update: "98cc38"
  notif/ux-design: "f382d0"

  prio/p0 : "f85963"
  prio/p1 : "e68b8a"
  prio/p2 : "fabaaf"
  prio/p3 : "faeadf"

  size/s: "edeca6"
  size/m: "fdf595"
  size/l: "fbdf78"
  size/xl: "fcc674"

  cat/bug: "e08891"
  cat/blocker: "dd6977"
  cat/feature: "bdd9f4"
  cat/enhancement: "93d273"
  cat/techdebt: "e7aeb6"
  cat/question: "8bd5e3"
  cat/retro: "84c68f"
  cat/process: "84c68f"
  cat/discussion: "1d4367"
  cat/quickwin: "a35e86"
  cat/starter: "e2704f"
  cat/research: "e9d355"
  cat/design: "cebdf8"

  target/tp1: "c6aad5"
  target/tp2: "bb98cb"
  target/tp3: "ae84c4"
  target/tp4: "8e6aaa"
  target/ga: "7e6eb1"

repos:
  rest:
    name: "syndesisio/syndesis-rest"
    label_mapping:
      big: "size/xl"
      WIP: "status/wip"
      Epic: "Epic"
      bug: "cat/bug"
      enhancement: "cat/enhancement"
      question: "cat/question"
      technical debt: "cat/debt"
      Retro Action Item: "cat/retro"
      wontfix: "cat/wontfix"
      blocked: "status/blocked"                                      
      TP1: "target/tp1"
      TP2: "target/tp2"
      TP3: "target/tp3"                                      
      approved: "approved"
  ui:
    name: "syndesisio/syndesis-ui"
    label_mapping:
      approved: "approved"
      bug: "cat/bug"
      "data mapper": "ext/atlasmap"
      "dev process": "cat/process"
      discussion: "cat/discussion"
      enhancement: "cat/enhancement"
      "good first issue": "cat/starter"
      "in progress": "status/wip"
      "Priority - Blocking": "prio/p0"
      "Priority - High": "prio/p1"
      "Priority - Low": "prio/p2"
      "Priority - never gonna happen": "prio/p3"
      question: "cat/question"
      refactoring: "cat/techdebt"
      research: "cat/research"
      "Retro Action Item": "cat/retro"
      "sprint requirement": "cat/feature"
      "support & docs": "ext/docs"
      "testing & qe": "ext/qe"
      "text changed": "notif/doc-update"
      "TP1": "target/tp1"
      "TP2": "target/tp2"
      "UX Design" : "notif/ux-design"
  project:
    name: "syndesisio/syndesis-project"
    label_mapping:
      approved: "approved"
      Blocker: "cat/blocker"
      Bug: "cat/bug"
      Enhancement: "cat/enhancement"
      Epic: "Epic"
      Feature: "cat/feature"
      Requirement: "cat/feature"
      "Retro Action Item": "cat/retro"
      TP1: "target/tp1"
      "UX Design": "notif/ux-design"
  verifier:
    name: "syndesisio/syndesis-verifier"
    label_mapping:
      approved: "approved"
  uxd:
    name: "syndesisio/syndesis-ux"
    label_mapping:
      approved: "approved"
      "Data Mapper": "ext/atlasmap"
      "project management": "cat/process"
      "UX Design": "cat/design"
      "UX Research": "cat/research"
      TP1: "target/tp1"
  tests:
    name: "syndesisio/syndesis-system-tests"
  connectors:
    name: "syndesisio/connectors"
    label_mapping:
      bug: "cat/bug"
      "Retro Action Item": "cat/retro"
      TP2: "target/tp2"
      TP3: "target/tp3"
  runtime:
    name: "syndesisio/syndesis-integration-runtime"
  s2i:
    name: "syndesisio/syndesis-s2i-image"      
  deploy:
    name: "syndesisio/syndesis-openshift-templates"
    label_mapping:
      approved: "approved"

You can see the colours of the labels here: https://github.com/syndesisio/issue-import-test/labels

Not to say its the best choice (i just picked random combinations from http://colorpalettes.net/.

Happy if @syndesisio/design-ux or @syndesisio/ui-api find a better and sound color scheme, we can change this always latter by updating the date above and rerun the label update script.

All 8 comments

I think we should add atlasmap or something similar in first level to cover cases when the issue is linked to Atlasmap repository and being worked on there.

...and what about priority labels. Something similar that is already used in syndesis-ui?

I think we also need a camel label at second level, like connector/camel so we know if it depends on camel.

I would add feature or story top level to the list.

I'd also change ux to uxd since it's for both UX & Design. Really minor detail though.

+1 on the priority labels (but I'm biased as I created those in the UI 馃槀 ).

Yeah, I really like the priorities labels we put in place in the ui repo. Also I'd suggest enhancement vs feat/feature. Or save feature for more of an epic-scoped thing, vs enhancement for a smaller-scoped improvement that isn't a bug fix.

Ok, I came up for now with the following label hierarchy, and mapping from old projects:

auth:
  user: "syndesis-bot"
  token: "...."

target: "syndesisio/issue-import-test"

labels:
  approved: "0ffa16"
  Epic: "364294"

  module/rest: "9d653d"
  module/ui: "dce6f0"
  module/deploy: "ab947d"
  module/runtime: "657c9a"
  module/s2i: "2b313c"
  module/connectors: "b39d9e"
  module/tests: "91ac83"
  module/uxd: "fdc5d8"
  module/verifier: "c6d74b"
  module/project: "e8a824"

  ext/atlasmap: "edb080"
  ext/camel: "c56b37"
  ext/docs: "f9d647"
  ext/qe: "91ac83"

  status/wip: "f5c73f"
  status/blocked: "ad0009"

  notif/doc-update: "98cc38"
  notif/ux-design: "f382d0"

  prio/p0 : "f85963"
  prio/p1 : "e68b8a"
  prio/p2 : "fabaaf"
  prio/p3 : "faeadf"

  size/s: "edeca6"
  size/m: "fdf595"
  size/l: "fbdf78"
  size/xl: "fcc674"

  cat/bug: "e08891"
  cat/blocker: "dd6977"
  cat/feature: "bdd9f4"
  cat/enhancement: "93d273"
  cat/techdebt: "e7aeb6"
  cat/question: "8bd5e3"
  cat/retro: "84c68f"
  cat/process: "84c68f"
  cat/discussion: "1d4367"
  cat/quickwin: "a35e86"
  cat/starter: "e2704f"
  cat/research: "e9d355"
  cat/design: "cebdf8"

  target/tp1: "c6aad5"
  target/tp2: "bb98cb"
  target/tp3: "ae84c4"
  target/tp4: "8e6aaa"
  target/ga: "7e6eb1"

repos:
  rest:
    name: "syndesisio/syndesis-rest"
    label_mapping:
      big: "size/xl"
      WIP: "status/wip"
      Epic: "Epic"
      bug: "cat/bug"
      enhancement: "cat/enhancement"
      question: "cat/question"
      technical debt: "cat/debt"
      Retro Action Item: "cat/retro"
      wontfix: "cat/wontfix"
      blocked: "status/blocked"                                      
      TP1: "target/tp1"
      TP2: "target/tp2"
      TP3: "target/tp3"                                      
      approved: "approved"
  ui:
    name: "syndesisio/syndesis-ui"
    label_mapping:
      approved: "approved"
      bug: "cat/bug"
      "data mapper": "ext/atlasmap"
      "dev process": "cat/process"
      discussion: "cat/discussion"
      enhancement: "cat/enhancement"
      "good first issue": "cat/starter"
      "in progress": "status/wip"
      "Priority - Blocking": "prio/p0"
      "Priority - High": "prio/p1"
      "Priority - Low": "prio/p2"
      "Priority - never gonna happen": "prio/p3"
      question: "cat/question"
      refactoring: "cat/techdebt"
      research: "cat/research"
      "Retro Action Item": "cat/retro"
      "sprint requirement": "cat/feature"
      "support & docs": "ext/docs"
      "testing & qe": "ext/qe"
      "text changed": "notif/doc-update"
      "TP1": "target/tp1"
      "TP2": "target/tp2"
      "UX Design" : "notif/ux-design"
  project:
    name: "syndesisio/syndesis-project"
    label_mapping:
      approved: "approved"
      Blocker: "cat/blocker"
      Bug: "cat/bug"
      Enhancement: "cat/enhancement"
      Epic: "Epic"
      Feature: "cat/feature"
      Requirement: "cat/feature"
      "Retro Action Item": "cat/retro"
      TP1: "target/tp1"
      "UX Design": "notif/ux-design"
  verifier:
    name: "syndesisio/syndesis-verifier"
    label_mapping:
      approved: "approved"
  uxd:
    name: "syndesisio/syndesis-ux"
    label_mapping:
      approved: "approved"
      "Data Mapper": "ext/atlasmap"
      "project management": "cat/process"
      "UX Design": "cat/design"
      "UX Research": "cat/research"
      TP1: "target/tp1"
  tests:
    name: "syndesisio/syndesis-system-tests"
  connectors:
    name: "syndesisio/connectors"
    label_mapping:
      bug: "cat/bug"
      "Retro Action Item": "cat/retro"
      TP2: "target/tp2"
      TP3: "target/tp3"
  runtime:
    name: "syndesisio/syndesis-integration-runtime"
  s2i:
    name: "syndesisio/syndesis-s2i-image"      
  deploy:
    name: "syndesisio/syndesis-openshift-templates"
    label_mapping:
      approved: "approved"

You can see the colours of the labels here: https://github.com/syndesisio/issue-import-test/labels

Not to say its the best choice (i just picked random combinations from http://colorpalettes.net/.

Happy if @syndesisio/design-ux or @syndesisio/ui-api find a better and sound color scheme, we can change this always latter by updating the date above and rerun the label update script.

old

Was this page helpful?
0 / 5 - 0 ratings