Describe the exercise's design, which includes its goal, learning objectives, prerequisites, and more. Markdown should be used to format the document. Check out the documentation, this video or this example design document for more information .
The exercise's name, which should reflect the Concept the exercise aims to teach. It should be in snake-case and adhere to the concept naming rules.
This is the first half of the instructions.md file. The story provides some context around the exercise. It can be be an actual story (e.g. playing with remote-controlled cars) or something more programming related (e.g. parsing log lines). This should generally contain no code samples. Markdown should be used to format the document. Check out the list of already implemented stories, the documentation, this video or this example instruction document for more information.
This is the second part of the instruction.md. It provides clear instructions of what a student needs to do to, in the form of one or more tasks. Each task should show a code snippet of the code being run and the expected output. Markdown should be used to format the document. Check out the documentation, this video or this example instruction document for more information.
Provide an example implementation of the tasks from the instructions. The implementation should be the solution we ideally want the student to produce, with consideration to the knowledge they have via the prerequisites. Only use language features introduced by the exercise or its prerequisites (and their prerequisites, and so on). Check out the documentation, this video or this example document for more information .
Introduce the concept(s) that the exercise teaches to the student. The information provided should give the student just enough context to figure out the solution themselves. Proper technical terms should be used so that the student can easily search for more information. Links should be used sparingly, if at all. Code examples should only be used to introduce new syntax (students should not need to search the web for examples of syntax). In other cases provide descriptions or links instead of code. Check out the documentation, this video or this example introduction document for more information .
The URL of the GitHub issue describing this exercise. Check out the open new exercise issues to see if there is an issue describing this exercise.
The token is used to associate the pull request that will be created with your account. You can find your CLI token by going to the settings page on exercism.io or by running exercism configure and examining its output.
exercism configure