Skip to content

Commit f18bdf2

Browse files
authored
Update glossary.yml (#36)
1 parent 1959476 commit f18bdf2

File tree

1 file changed

+73
-3
lines changed

1 file changed

+73
-3
lines changed

data/glossary.yml

+73-3
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,8 @@
3232
## ```
3333

3434
- term: Abandoned kata
35-
description: Kata whose the author is not active anymore.
35+
description: |
36+
Kata whose the author is not active anymore.
3637
3738
- term: Active (author)
3839
description: Author who has been connected to Codewars during the last 30 days.
@@ -55,6 +56,25 @@
5556
- term: Beta (kata/process)
5657
description: The beta process is the phase where a kata is visible to any other user in the database/[katas search page](https://www.codewars.com/kata/my-languages) but does not have a rank yet. It is to be tested by other users, so that it can be enhanced, modified, ranked and finally approved... or retired if not qualitative enough.
5758

59+
- term: Clan(s)
60+
description: |
61+
You can write the name of your clan/company/organization through your `profile/account settings` page. All the members of this clan are automatically recognized as allies of yours, hence are added to your personnal leaderboard in the dashboard.
62+
links:
63+
- title: Dashboard leaderboard
64+
url: https://www.codewars.com/dashboard
65+
66+
- term: Collections(s)
67+
description: |
68+
Collections are sets or libraries of katas that any user can create, for any purpose. All collections are public.
69+
links:
70+
- title: Collections created by one user
71+
url: https://www.codewars.com/users/Blind4Basics/authored_collections
72+
- title: Browse through all collections
73+
url: https://www.codewars.com/collections
74+
75+
- term: Console
76+
description: Synonym for "output panel" (see below).
77+
5878
- term: Contributor(s)
5979
description: User(s) who have either authored, approved, translated or modified a kata in any way (a list of them can be seen in the "Details" page of any kata.
6080

@@ -99,10 +119,19 @@
99119
- term: Forfeit (a kata)
100120
description: |
101121
You forfeit a kata when you do one of those actions:
102-
* you unlock the solutions (through the button in the trainer, for example)
103-
* you enter the edit panel (_warning_: power users may have the possibility to enter the edit panel of some katas. If you do so before you solved it, you actually forfeit it).
122+
* You unlock the solutions (through the button in the trainer, for example)
123+
* You enter the edit panel (_warning_, power users may have the possibility to enter the edit panel of some katas. If you do so before you solved it, you actually forfeit it).
104124
Forfeiting a kata makes you lose the opportunity to gain honor points or progress by completing this kata.
105125
126+
- term: Fork
127+
description: |
128+
In the solutions page of a kata, you can see the solutions of other users, and you can `fork` them to suggest modifications/enhancements (button below each solution).
129+
Using the fork panel is the right way to try out a solution of another user, rather than to copy it in the trainer of the kata.
130+
131+
- term: Honor (points)
132+
description: |
133+
Honor points are the score that is showing up in the top right corner, aside of your avatar. You can win honor points in different ways (completing katas, up votes on your comments or solutions, translations, creating katas, ...)
134+
106135
- term: Inactive (author)
107136
description: |
108137
Author of a kata who hasn't been connected for more than 30 days. When an author is inactive, some actions he's normally the only person allowed to do are doable by other people (power users with the required privilegees).
@@ -138,6 +167,47 @@
138167
- title: Kyū - Wikipedia
139168
url: https://en.wikipedia.org/wiki/Ky%C5%AB
140169

170+
- term: Language versions
171+
description: |
172+
A kata may be available in one or more languages (javascript, python, coq, ...), and for each language there may be different versions like Node 8 or Node 10 for JS, python 3.4.3 or 3.6, ... You can choose the language _and_ the language version in the trainer of a kata (amongst the available ones only).
173+
174+
- term: Leaderboards
175+
description: Leaderboards are grouping different users according to different criteria.
176+
links:
177+
- title: Overall top 500
178+
url: https://www.codewars.com/users/leaderboard
179+
- title: Top 500 by completed Katas
180+
url: https://www.codewars.com/users/leaderboard/kata
181+
- title: Top 500 by authored Katas and translations
182+
url: https://www.codewars.com/users/leaderboard/authored
183+
- title: Your personnal leaderboard (with your allies, in the dashboard)
184+
url: https://www.codewars.com/dashboard
185+
186+
- term: Markdowns (formatting)
187+
description: |
188+
Codewars is responsive to `markdowns`. They allow you to format code, descriptions or comments so that thay are properly readable for other users.
189+
190+
- term: Merge conflicts
191+
description: |
192+
When a translation of a kata is published but some changes are done to the description (through the edit panel) before the translation gets approved, it becomes impossible to approve it because of those "merge conflicts".
193+
To resolve this problem, you have to fork the translation and update the description starting with its current (new) version.
194+
195+
- term: Mutation of the input
196+
description: |
197+
To keep it short...: ___Don't mutate the input... Ever___ (eg. don't use sort, append, push, remove, ... and alike before doing a copy of the input).
198+
This is about side effects, modifying the arguments (typically lists/arrays, or even strings if they are mutable in your language) sent to your function during the executions. This can have weird consequences, depending on how the tests are written.
199+
Nowadays, most test suites are written in a way that avoids this kind of problem but typically, if you end up passing the fixed tests but failing all the random tests with something along the line of `[your result] should equal []`, you're most likely facing a "mutation of the input" problem.
200+
Hence... Don't mutate the input.
201+
202+
- term: Preloaded (code/section)
203+
description: |
204+
In a Kata, the preloaded section is code that is executed _before_ the solution of the user is defined. The code hold by this section isn't visible to the user but every function or variable defined there is accessible to him drugint the executions of his code.
205+
If you need/want to see the preloaded section of a Kata, open a fork of a solution _after_ you solved it and look to the `Preloaded` panel.
206+
207+
- term: Progress
208+
description: |
209+
Aside of honor points, you gain "progress" by completing Katas (and only that way). Progess is what is conditioning your current rank as a codewarrior.
210+
141211
- term: Publishing (kata)
142212
description: When you hit "publish" in the edit panel of a kata you created, it enters the beta process and becomes visible to anyone in the [katas search page](https://www.codewars.com/kata/my-languages). The beta process begins at the moment a kata is published.
143213

0 commit comments

Comments
 (0)