-
-
Notifications
You must be signed in to change notification settings - Fork 41
Description
The inclusion of a .docs/hints.md file is officially optional, and was originally rare. As Exercism has matured, the value of these files to both students and mentors is increasingly recognized. Their inclusion is encouraged, at least for new exercises (both practice and concept).
I just did a search of r/exercises/practice/, and the only hints file I found was vehicle-purchase/.docs/hints.md. Even that is just an empty stub!
Adding more is not urgent, but would be valuable if anyone wants to attempt it. We only need a single file per exercise.
The basic style is a bulleted list containing links to relevant documentation. Probably short for a practice exercise, more detailed and step-by-step for a concept exercise (though that's another missing feature of the R track). Here is an example from the Python track.
Writing Approaches documents is an alternative, but that is a lot more work. See Reverse String for an example.