Skip to content

Conversation

@sanderploegsma
Copy link
Contributor

The exercises/shared/.docs/representations.md file contents are displayed in the Automations part of the website used by mentors to set up automated mentor feedback on solution sets grouped by their representations. This is explained here: https://exercism.org/docs/building/tracks/shared-files#h-file-representations-md

Fixes #2699


Reviewer Resources:

Track Policies

@sanderploegsma sanderploegsma added the x:size/small Small amount of work label Feb 2, 2024
The exercises/shared/.docs/representations.md file contents are displayed in the Automations part of the website used by mentors to set up automated mentor feedback on solution sets grouped by their representations. This is explained here: https://exercism.org/docs/building/tracks/shared-files#h-file-representations-md
@sanderploegsma sanderploegsma force-pushed the add-representations-docs branch from ff1b41b to fbc7190 Compare February 2, 2024 19:45
@sanderploegsma
Copy link
Contributor Author

I also noticed that the Elixir track contains more documentation on how these normalizations work: https://github.com/exercism/elixir/blob/d0f255138e0b13eb81e364e2ab6c3a9aa498e540/exercises/shared/.docs/representations.md

I'd like to add this as well, but since the representer might be overhauled soon after merging exercism/java-representer#109 I'd like to hold off on that for now.

@manumafe98
Copy link
Contributor

I'd like to add this as well, but since the representer might be overhauled soon after merging exercism/java-representer#109 I'd like to hold off on that for now.

Do you think we should go ahead and merge this representation until the change is merged or we should wait?

@sanderploegsma
Copy link
Contributor Author

Currently this file describes the representer as it is running right now, so I'd say we merge this.

@sanderploegsma sanderploegsma merged commit 5888577 into main Feb 2, 2024
@sanderploegsma sanderploegsma deleted the add-representations-docs branch February 2, 2024 22:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

x:size/small Small amount of work

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add document to describe the representation process for mentors

3 participants