Add a note about exercise ordering in the launch checklist #18
Conversation
CHECKLIST
Outdated
| @@ -24,6 +24,8 @@ The topics can be an empty list, and the difficulty level is from 1 to 10, and c | |||
| ] | |||
| ``` | |||
|
|
|||
| The order of the exercises is decided by the order in this "exercises" array. Try to make them roughly increasing in difficulty, but don't worry too much—we can always adjust the order later, as we get feedback from people doing the exercises. | |||
There was a problem hiding this comment.
May I suggest a little word smithing?
Problems are delivered to users in the same order that they are listed in this "exercises" array. Try to order them by increasing difficulty, but don't worry too much—it can always be adjusted later.
, as we get feedback from people doing the exercises. - We don't have any specific mechanism for gathering this feedback that I know of.
There was a problem hiding this comment.
So what is the plan with the difficulty ranking? Are we going to use this only as an indication to contributors on where to place the exercise in the list of exercises or are we going to use those at some point to sort the exercises programmatically?
There was a problem hiding this comment.
I like the wordsmithing. I'll take it.
We don't have a dedicated feedback mechanism, but people do give us feedback.
I don't know if we'll sort things programmatically. I've been working with the UX folks on some of these questions. When I've got my head wrapped around it, I'll talk about it more.
@jonmcalder noted in exercism/r#5 (comment) that we haven't explained anything about exercise order. I've tried to add a small improvement here.
I've also opened an issue to start documenting our philosophy around tests, which would be handy to have! exercism/docs#8