Open ErikSchierboom opened 3 years ago
Hello, the links from
"You can use the following documents to learn more about building a representer:"
in representer are outdated I think I know where are the updated links are, I just don't know how to update them.
@43v3rn88b The docs are meant to be viewed from the website: https://exercism.org/docs/building/tooling/representers, where the links do work
ok, somehow I was being redirected here when I click the link for building a representer for Scala. Thanks anyway!
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.
The representer is an optional tool though, which means that if a track does not have a representer, it will still function normally.
Goal
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.
If your track already has a working representer, please close this issue and ensure that the
.status.representer
key in the trackconfig.json
file is set totrue
.Choosing between representer and analyzer
There is some overlap between the goals of the representer and the 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/52