So you want to help out with the Elixir track on Exercism? That's awesome! 💜
There are plenty of tasks that you can help with.
If you have any questions, if you're unsure where to start or you're stuck, do not hesitate to ask for help in our #maintaining-elixir Slack channel.
Check open issues in PRs in the exercism/v3 repository to see which concepts need a new exercise or an improvement.
You can read through existing concepts and concept exercises, and suggest improvements. Even a fixed typo or a grammar error will be highly appreciated!
To prepare for this task, make sure to read the documentation about concept exercises. They are different from the exercises you already know from Exercism.
- Open issues and PRs for Elixir in v3
- V3 Elixir concept exercises
- V3 Elixir concepts
- V3 contributing dashboard
- The features of v3.
- Rationale for v3.
- What are concept exercise and how they are structured?
An analyzer is a tool that analyzes the AST of an exercise solution looking for specific features. Based on the results, it can leave helpful comments for the student.
Some v3 concept exercises must have an analyzer. They won't be mentored, and their goal is to teach how to use specific features of the language, so we need to look out for solutions that pass the tests, but don't use the taught features.
You will recognize the exercises that need an analyzer by their design.md
file containing an "analyzer" section
that outlines what features of a desired solution need to be checked for
(example).
You can choose any exercise that doesn't already have an analyzer and try to implement one.
This task isn't as difficult as it might sound! We already have the tool for this job. It's all about using it to describe the desired features of a good solution. See the example PR.
- V3 Elixir concept exercises
- Currently implemented analyzers
- How to write an analyzer?
- Example PR adding an analyzer for the pacman-rules exercise
- Elixir's automated comments
To launch v3, we need a well-working analyzer, test runner, and representer. All of those projects are already created and functional, but they might still need some improvements.
V3 is our current focus, but really don't want to get involved with it at the moment, you can also check if the current Elixir track has open issues or PRs that could benefit from more attention.