Closed ErikSchierboom closed 3 years ago
mpizenberg
commented
3 years ago I don't see it mentioned in the docs but representers are for both concept and practice right? Our representer is very simple but should work on both. @ErikSchierboom is there a way we can test it online (I suppose once v3 PR has been merged?)
ErikSchierboom
commented
3 years ago Yes, that is correct, they should work on both concept and practice exercises!
@iHiD are representers currently being run automatically on the staging website?
mpizenberg
commented
3 years ago @ErikSchierboom Seems like they are :) https://exercism.lol/maintaining/exercise_representations
ErikSchierboom
commented
3 years ago Ah cool.
iHiD
commented
3 years ago Great! :D
ErikSchierboom
commented
3 years ago We're closing this issue as two separate issues have been created to replace this combined issue.
This issue is part of the migration to v3. You can read full details about the various changes here.
Representer
In Exercism v3, we're introducing a new (optional) tool: the representer. The goal of the representer is to take a solution and returning a representation, which is an extraction of a solution to its essence with normalized names, comments, spacing, etc. but still uniquely identifying the approach taken. Two different ways of solving the same exercise must not have the same representation.
Each representer is track-specific. When a new solution is submitted, we run the track's representer, which outputs two JSON files that describe the representation.
Once we have a normalized representation for a solution, a team of vetted mentors will look at the solution and comment on it (if needed). These comments will then automatically be submitted to each new solution with the same representation. A notification will be sent for old solutions with a matching representation.
Each track should build a representer according to the spec. For tracks building a representer from scratch, we have a starting guide.
The representer is an optional tool though, which means that if a track does not have a representer, it will still function normally.
Analyzer
In Exercism v3, we are making increased use of our v2 analyzers. Analyzers automatically assess student's submissions and provide mentor-style commentary. They can be used to catch common mistakes and/or do complex solution analysis that can't easily be done directly in a test suite.
Each analyzer is track-specific. When a new solution is submitted, we run the track's analyzer, which outputs a JSON file that contains the analysis results.
In v2, analyzer comments were given to a mentor to pass to a student. In v3, the analyzers will normally output directly to students, although we have added an extra key to output suggestions to mentors. If your track already has an analyzer, the only requisite change is updating the outputted copy to be student-facing.
Each track should build an analyzer according to the spec. For tracks building an analyzer from scratch, we have a starting guide.
The analyzer is an optional tool though, which means that if a track does not have an analyzer, it will still function normally.
Goal 1
Build a representer for your track according to the spec. Check this page to help you get started with building a representer.
Note that the simplest representer is one that merely returns the solution's source code.
It can be very useful to check how other tracks have implemented their representer.
Goal 2
Build an analyzer for your track according to the spec. Check this page to help you get started with building an analyzer.
It can be very useful to check how other tracks have implemented their analyzer.
Choosing between representer and analyzer
If you want to build both, we recommend starting by building the representer for the following reasons:
Tracking
https://github.com/exercism/v3-launch/issues/8