-
-
Notifications
You must be signed in to change notification settings - Fork 645
Description
Goal
The goal of this task is to make sure the Concept Exercise "Elyses Analytic Enchantments" and the Concept array-analysis
conform to the latest specification and include all the needed content.
Getting Started
The docs can be found here
Additionally you can look at the bird-watcher
concept exercise for reference.
Tasks
Write the introduction for the array analysis concept
The main task is to change the introduction.md file of the exercise to contain some minimal information so that the student is able to solve the exercise. For now it is ok to use that same content as introduction.md and about.md for the array-analysis
Concept as well. To know what content the student needs in the exercise, check out the exemplar file.
An idea for the introduction file is to pick a common "analysis" method like includes
and first show how to do this with just a for loop. Then show how it can be shortened by using the method. This could be followed by a list of the methods needed in the exercise (+ maybe some other commonly used ones) with a short explanation. The method name can be a link to MDN. There is no need to write a separate section explaining/demonstrating each method. You can see an example for this here: https://github.com/exercism/javascript/blob/main/concepts/strings/introduction.md#concatenation-and-methods
Improve the tests
- Make sure the tests are declarative (see [V3] Improve Annalyn's infiltration by making the tests declarative #1019 for an example)
- Make sure each test case is "self-contained" so that the student sees meaningful output from the test runner (no forEach, no "table driven" tests, no helper functions or variables defined outside of the test case etc.)
Bonus Tasks
- Proof-read the remaining content of the exercise (instructions, hints, etc)
- Make sure there are good blurbs for the concept and the exercise