You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/curation/howtos/fixing.md
+9-5Lines changed: 9 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ The first step to fixing a Codewars kata is determining which kata need fixing i
10
10
11
11
- On the [kata search page](https://www.codewars.com/kata/my-languages), every entry shows the number of pending issues (if any).
12
12
- Posts on the home page [dashboard](https://www.codewars.com/dashboard/discourse/issues) can be filtered to display the most recently reported issues.
13
-
- The discourse page of every kata can be filtered for posts labeled as `ISSUE`.
13
+
- The discourse page of every kata can be filtered for posts labeled as `ISSUE` or `SUGGESTION`.
14
14
- The [kata search page](https://www.codewars.com/kata/) can be used to find challenges that have not been updated to the latest version of their available languages. For example, to find kata with tests that need to be updated to the latest available version of JavaScript, filter for language: JavaScript, and manually add the parameter `&outdated=1` to the URL (example link to find all [outdated JavaScript kata](https://www.codewars.com/kata/search/javascript?q=&order_by=sort_date%20desc&outdated=1)).
15
15
- The [`codewars/content-issues`](https://github.com/codewars/content-issues) GitHub repository hosts [wiki pages](https://github.com/codewars/content-issues/wiki) with lists of kata that need an update and an [issue board](https://github.com/codewars/content-issues/issues) with tickets related to kata maintenance.
16
16
@@ -23,7 +23,7 @@ Fixes should not be applied by starting with a fork of an already approved fork.
23
23
:::
24
24
25
25
:::warning Prefer forks to direct edits
26
-
Applying fixes via forks is preferred over updates done with the kata editor. Forks can be reviewed, and reviewers can share their remarks before approving the fix.
26
+
Applying fixes via forks is preferred over updates done using the kata editor. Forks can be reviewed, and reviewers can share their remarks before approving the fix.
27
27
:::
28
28
29
29
### Scope of a fix
@@ -32,21 +32,25 @@ A single Codewars challenge can be affected by multiple problems. It may be temp
32
32
33
33
A user must find a balance between making large-scale fixes that attempt to address many issues at once and smaller, incremental changes that are easier to review and approve. Sometimes, applying a series of small fixes is more effective than attempting to fix multiple issues in a single fork.
34
34
35
-
It is recommended to write a short post on a published fork explaining what problems it addresses.
35
+
It is recommended to write a short comment in the discourse of a published fork explaining what problems it addresses.
36
36
37
37
### Announcing the fork
38
38
39
39
When a fork with a fix is ready, it needs to be published for review and potential merging. To notify reviewers about a fork ready for review, it can be helpful to announce the fix with a message posted in the discourse section of the kata (labeled as `SUGGESTION`) and in the `#fixing` channel of the Codewars Discord.
40
40
41
-
###Review of a fork
41
+
## Review of a fork
42
42
43
43
After a fork with a fix is published and announced, it should attract the attention of reviewers who will evaluate it and either approve it or request further improvements.
44
44
45
45
Users with sufficient privileges can approve their own forks without waiting for a review.
46
46
47
47
When a reviewer requests further improvements, they can be added to the same fork. It is not necessary to fork a fork if it hasn't been approved or rejected. However, if the fork has already been merged and further improvements are required, it must be re-forked. Editing an approved fork is possible, but there is no way to merge the new changes into the kata.
48
48
49
-
### Resources on fixing
49
+
## Pitfall: editing descriptions
50
+
51
+
Updading a kata description, with a fork or in any other way, renders all pending translations and update forks of this kata impossible to approve due to description merge conflicts. While unfortunate, it is not a serious impediment for fixing activities, because merge conflicts are relatively [easy to fix](/curation/translation/#merge-issues).
52
+
53
+
## Resources on fixing
50
54
51
55
Users interested in fixing Codewars challenges have several resources at their disposal:
0 commit comments