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 |
- Fixing a single typo or link
- Removing a blank line or adding a line break
- Changing/adding a single code comment
|
-| `x:size/small` | 5 | - Fixing a single test case, task or example
- Fixing multiple typos or links in a single file
- Clarifying content by adding a few lines to a file
|
-| `x:size/medium` | 12 | - Syncing an exercise with problem-specifications (incl. edits)
- Adding one or more test cases from scratch
- Improving multiple files in an exercise
- Adding mentor notes for an exercise from scratch
- Fixing a small bug in a test runner/analyzer/representer
- Adding analyzer comments for a single exericse
|
-| `x:size/large` | 30 | - Adding a new concept or practice exercise
- Adding new concept documentation
- Substantial re-writing of an existing concept or exercise
- Adding new CI scripts or other automation
|
-| `x:size/massive` | 100 | - Creating a test-runner, analyzer, representer or generator from scratch
- Major refactors to those tools
- Creating major documentation from scratch (e.g. contribution or testing guides)
|
+| Label | Reputation | Examples |
+| --------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `x:rep/tiny` | 3 | - Fixing a single typo or link
- Removing a blank line or adding a line break
- Changing/adding a single code comment
|
+| `x:rep/small` | 5 | - Fixing a single test case, task or example
- Fixing multiple typos or links in a single file
- Clarifying content by adding a few lines to a file
|
+| `x:rep/medium` | 12 | - Syncing an exercise with problem-specifications (incl. edits)
- Adding one or more test cases from scratch
- Improving multiple files in an exercise
- Adding mentor notes for an exercise from scratch
- Fixing a small bug in a test runner/analyzer/representer
- Adding analyzer comments for a single exericse
|
+| `x:rep/large` | 30 | - Adding a new concept or practice exercise
- Adding new concept documentation
- Substantial re-writing of an existing concept or exercise
- Adding new CI scripts or other automation
|
+| `x:rep/massive` | 100 | - Creating a test-runner, analyzer, representer or generator from scratch
- Major refactors to those tools
- Creating major documentation from scratch (e.g. contribution or testing guides)
|
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 | - Fully-fleshed out Concept Exercise
|
+| `x:rep/massive` | 100 | - Designing a track curriculum
|
+
+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.