traefik/docs/content/contributing/maintainers.md

7.3 KiB
Raw Blame History

Maintainers

The team

Contributions Daily Meeting

  • 3 Maintainers should attend to a Contributions Daily Meeting where we sort and label new issues (is:issue label:status/0-needs-triage), and review every Pull Requests
  • Every pull request should be checked during the Contributions Daily Meeting
    • Even if its already assigned
    • Even PR labelled with contributor/waiting-for-corrections or contributor/waiting-for-feedback
  • Issues labeled with priority/P0 and priority/P1 should be assigned.
  • Modifying an issue or a pull request (labels, assignees, milestone) is only possible:
    • During the Contributions Daily Meeting
    • By an assigned maintainer
    • In case of emergency, if a change proposal is approved by 2 other maintainers (on Slack, Discord, Discourse, etc)

PR review process:

  • The status needs-design-review is only used in complex/heavy/tricky PRs.
  • From 1 to 2: 1 comment that says “design LGTM” (by a senior maintainer).
  • From 2 to 3: 3 LGTM approvals by any maintainer.
  • If needed, a specific maintainer familiar with a particular domain can be requested for the review.
  • If a PR has been implemented in pair programming, one peer's LGTM goes into the review for free
  • Amending someone else's pull request is authorized only in emergency, if a rebase is needed, or if the initial contributor is silent

We use PRM to manage locally pull requests.

Bots

Myrmica Lobicornis

Update and Merge Pull Request.

The maintainer giving the final LGTM must add the status/3-needs-merge label to trigger the merge bot.

By default, a squash-rebase merge will be carried out. To preserve commits, add bot/merge-method-rebase before status/3-needs-merge.

The status status/4-merge-in-progress is only used by the bot.

If the bot is not able to perform the merge, the label bot/need-human-merge is added.
In such a situation, solve the conflicts/CI/... and then remove the label bot/need-human-merge.

To prevent the bot from automatically merging a PR, add the label bot/no-merge.

The label bot/light-review decreases the number of required LGTM from 3 to 1.

This label is used when:

  • Updating the vendors from previously reviewed PRs
  • Merging branches into the master
  • Preparing the release

Myrmica Bibikoffi

  • closes stale issues [cron]
    • use some criterion as number of days between creation, last update, labels, ...

Myrmica Aloba

Manage GitHub labels.

  • Add labels on new PR [GitHub WebHook]
  • Add milestone to a new PR based on a branch version (1.4, 1.3, ...) [GitHub WebHook]
  • Add and remove contributor/waiting-for-corrections label when a review request changes [GitHub WebHook]
  • Weekly report of PR status on Slack (CaptainPR) [cron]

Labels

A maintainer that looks at an issue/PR must define its kind/*, area/*, and status/*.

Status - Workflow

The status/* labels represent the desired state in the workflow.

  • status/0-needs-triage: all the new issues and PRs have this status. [bot only]
  • status/1-needs-design-review: needs a design review. (only for PR)
  • status/2-needs-review: needs a code/documentation review. (only for PR)
  • status/3-needs-merge: ready to merge. (only for PR)
  • status/4-merge-in-progress: merge is in progress. [bot only]

Contributor

  • contributor/need-more-information: we need more information from the contributor in order to analyze a problem.
  • contributor/waiting-for-feedback: we need the contributor to give us feedback.
  • contributor/waiting-for-corrections: we need the contributor to take actions in order to move forward with a PR. (only for PR) [bot, humans]
  • contributor/needs-resolve-conflicts: use it only when there is some conflicts (and an automatic rebase is not possible). (only for PR) [bot, humans]

Kind

  • kind/enhancement: a new or improved feature.

  • kind/question: a question. (only for issue)

  • kind/proposal: a proposal that needs to be discussed.

    • Proposal issues are design proposals
    • Proposal PRs are technical prototypes that need to be refined with multiple contributors.
  • kind/bug/possible: a possible bug that needs analysis before it is confirmed or fixed. (only for issues)

  • kind/bug/confirmed: a confirmed bug (reproducible). (only for issues)

  • kind/bug/fix: a bug fix. (only for PR)

Resolution

  • resolution/duplicate: a duplicate issue/PR.
  • resolution/declined: declined (Rule #1 of open-source: no is temporary, yes is forever).
  • WIP: Work In Progress. (only for PR)

Platform

  • platform/windows: Windows related.

Area

  • area/acme: ACME related.
  • area/api: Traefik API related.
  • area/authentication: Authentication related.
  • area/cluster: Traefik clustering related.
  • area/documentation: Documentation related.
  • area/infrastructure: CI or Traefik building scripts related.
  • area/healthcheck: Health-check related.
  • area/logs: Logs related.
  • area/middleware: Middleware related.
  • area/middleware/metrics: Metrics related. (Prometheus, StatsD, ...)
  • area/middleware/tracing: Tracing related. (Jaeger, Zipkin, ...)
  • area/oxy: Oxy related.
  • area/provider: related to all providers.
  • area/provider/boltdb: Boltd DB related.
  • area/provider/consul: Consul related.
  • area/provider/docker: Docker and Swarm related.
  • area/provider/ecs: ECS related.
  • area/provider/etcd: Etcd related.
  • area/provider/eureka: Eureka related.
  • area/provider/file: file provider related.
  • area/provider/k8s: Kubernetes related.
  • area/provider/kv: KV related.
  • area/provider/marathon: Marathon related.
  • area/provider/mesos: Mesos related.
  • area/provider/rancher: Rancher related.
  • area/provider/servicefabric: Azure service fabric related.
  • area/provider/zk: Zoo Keeper related.
  • area/rules: Rules related.
  • area/server: Server related.
  • area/sticky-session: Sticky session related.
  • area/tls: TLS related.
  • area/websocket: WebSocket related.
  • area/webui: Web UI related.

Issues Priority

  • priority/P0: needs hot fix.
  • priority/P1: need to be fixed in next release.
  • priority/P2: need to be fixed in the future.
  • priority/P3: maybe.

PR size

Automatically set by a bot.

  • size/S: small PR.
  • size/M: medium PR.
  • size/L: Large PR.