👋Learning to code? Check out ourbrand new Bootcampfor beginners!
What to consider before suggesting exercise improvements
So you've found something you'd like to improve about an exercise. Firstly, thank you for caring, and for making the time to tell us! 💙
When changing an exercise, there are a few things to consider, and they're slightly different for Learning Exercises (those that teach topics in the Syllabus) and Practice Exercises (the rest). We go into those differences below.
However, firstly there are a couple of generic things to consider.
There are quite a few consequences in changing an exercise:
For all these reasons, we are careful to only change exercises where there's a strong identifiable benefit.
The aim of exercises' test suites is not to be comprehensive about all possible cases. Our exercises are not production software, nor are they designed to imitate real-world use-cases. They are designed to be toy-problems to help you gain fluency in a programming language. We therefore deliberately avoid trying to cover every edge-case, forcing lots of input validation, or other such real-world concerns. If your suggested improvement is to catch an edge-case or to check input-validation, it's unlikely to be accepted unless it makes a substantial difference to the exercise.
Learning Exercises are designed with one goal: to teach concepts. All changes to an exercise will first and foremost be considered against whether they improve the teaching of the concepts.
Learning Exercises are (especially) not designed to be exhaustive in their tests. They can also often be slightly contrived or obtuse to avoid using concepts a student has not yet learned, or so as not to overwhelm a student.
If your suggested change could potentially distract from the learning of the concept, it will probably get rejected. If the change makes the learning easier, it'll be strongly considered. If it sits somewhere in between, it may be accepted, but is unlikely to be prioritised.
The main thing to understand about Practice Exercises is that nearly all of them live in a central repository (known as "Problem Specifications"). Making a change to an exercise therefore has knock-on effects over all tracks. That means a good change is extra powerful as it'll help all languages. But it also increases the burden of the change, as multiple cross-track maintainers need to agree to the change for it to be accepted, and then each language's maintainers need to pull the changes downstream into their tracks.
Changes to exercises can also mean that the concepts they're linked to in syllabuses become muddier, or that exercises need extra features to solve, which changes where they become unlocked. This also needs to be considered across tracks before changes are accepted.
While we do have mechanisms for only some tracks to have certain test-cases, we tend to discourage it, as this forking can offer confusion to both maintainers and students. So when proposing changes to Practice Exercises, please consider the bigger picture across tracks.
Although there are a lot of reasons that we don't accept suggestions, a lot of the time people come up with great ideas that we do accept!
We're also nearly always open to changes in wording that add clarity, especially in Learning Exercises.
To give your suggestions the best shot of being approved, please write out your suggestions showing that you've considered the following:
And please remember to express opinions as opinions and facts as facts. That tends to lead to the most productive conversations.
Thanks again for taking the time to make a suggestion and for reading this document!