Improve Concept Exercise: Elyses Enchantments (`arrays`)

Related: https://github.com/exercism/support/issues/28#issuecomment-926606144

This is a tiny task. The stubbed JSDoc can be improved.

Current JSDoc

/**
 * Remove the card at the 0-based position
 * 
 ...
 */

Proposal

Change this JSDoc to make it clear that the card at the given position must be removed. Perhaps we say: position 0 is the first position or something like that. 0-based and 1-based indexation isn’t a concept that’s necessarily clear, so making it more easy to discover might help future students.

[pertrai1]

I’d like to work on this

[junedev]

@pertrai1 Thanks for offering to help! First of all please note that this issue is just about clarifying the JSDoc and the exercise instructions with regards to the position parameter. (I made a typo in my comment above by writing “introduction”, sorry for that.)

There is another ticket for fixing the introduction: https://github.com/exercism/javascript/issues/1339
Someone already volunteered for this but since there was no activity for a while feel free to ask there whether you can take over the task.

Now to your question regarding the comments in the examples. Usually we would give the explanation in the text and then the example is really just the example. Otherwise it can get confusing what information is given in the text vs. the comments of the example (or one is more or less a duplicate of the other). Of course there are some special cases where a comment is needed but that’s rather an exception than the rule. Have a look here for an example of the system I described https://github.com/exercism/javascript/blob/main/concepts/objects/introduction.md#retrieving-a-value