diff --git a/using/product/reputation.md b/using/product/reputation.md index 9003c1ae..1e939389 100644 --- a/using/product/reputation.md +++ b/using/product/reputation.md @@ -65,21 +65,22 @@ By default, `12` reputation is awarded when a pull request is merged that was op Depending on the content of the pull request, a maintainer can award more (or less) reputation by adding one of the following labels to the pull request: -| Label | Reputation | Examples | -| ---------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `x:size/tiny` | 3 | | -| `x:size/small` | 5 | | -| `x:size/medium` | 12 | | -| `x:size/large` | 30 | | -| `x:size/massive` | 100 | | +| Label | Reputation | Examples | +| --------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `x:rep/tiny` | 3 | | +| `x:rep/small` | 5 | | +| `x:rep/medium` | 12 | | +| `x:rep/large` | 30 | | +| `x:rep/massive` | 100 | | The examples above can serve as rough orientation when to apply which label but maintainers are free to use their own judgement. +- The estimated number of time spent should be interpreted as the average time a _maintainer_ would spend on doing the PR. - If more than one label is specified, the label with the highest reputation value determines the awarded reputation. - If a pull request is still open, no reputation is awarded (yet). - If a pull request is closed _without_ merging, no reputation is awarded. -Note that an `x:size` label on an **issue** never affects the awarded reputation - even if a merged pull request lacks an `x:size` label, and closes an issue that has one. +_For backwards compatibility purposes, we also support using the `x:size` labels to determine the awarded reputation._ ### Reviewing a pull requests @@ -91,16 +92,21 @@ For each merged or closed pull request reviewed by the user, `5` reputation is a - The reputation awarded for a pull request review changes if one of the following labels are added to the pull request: - | Label | Reputation | - | ---------------- | ---------- | - | `x:size/tiny` | 1 | - | `x:size/small` | 2 | - | `x:size/medium` | 5 | - | `x:size/large` | 10 | - | `x:size/massive` | 20 | + | Label | Reputation | + | --------------- | ---------- | + | `x:rep/tiny` | 1 | + | `x:rep/small` | 2 | + | `x:rep/medium` | 5 | + | `x:rep/large` | 10 | + | `x:rep/massive` | 20 | + + It is _not_ possible to use different reputation "sizes" for a pull request author and reviewer. + Both are based on the same `x:rep` label. If more than one label is specified, the label with the highest reputation value determines the awarded reputation. + _For backwards compatibility purposes, we also support using the `x:size` labels to determine the awarded reputation._ + ### Merging a pull request For each pull request that was merged by the user, `1` reputation is awarded. @@ -109,3 +115,21 @@ For each pull request that was merged by the user, `1` reputation is awarded. - If a pull request is closed _without_ merging, no reputation is awarded. - The user that opened the pull request does _not_ get reputation for merging their own pull request. - If the pull request does not have any reviews, `5` reputation is awarded instead. + +### Opening an issue + +Like pull requests, by default, **no reputation is awarded** when an issue is opened. +Unlike pull requests, reputation is only awarded for large or massive issues. + +Depending on the content of the issue, a maintainer can choose to award reputation by adding one of the following labels to the issue: + +| Label | Reputation | Examples | +| --------------- | ---------- | ---------------------------------------------------- | +| `x:rep/large` | 30 | | +| `x:rep/massive` | 100 | | + +The examples above can serve as rough orientation when to apply which label, but maintainers are free to use their own judgement. + +- The reputation should reflect the amount of effort that _maintainer_ would spend to create the issue. + +- If more than one label is specified, the label with the highest reputation value determines the awarded reputation.