Explorar el Código

Update new exercise guide to mention version file

Frida Tveit hace 9 años
padre
commit
3ee6f6f6e3
Se han modificado 1 ficheros con 8 adiciones y 0 borrados
  1. 8
    0
      CONTRIBUTING.md

+ 8
- 0
CONTRIBUTING.md Ver fichero

164
 The `build.gradle` file can just be copied from any other exercise submodule.
164
 The `build.gradle` file can just be copied from any other exercise submodule.
165
 See the [POLICIES doc](https://github.com/exercism/java/blob/master/POLICIES.md#starter-implementations) for an explanation of when you need to add a starter implementation.
165
 See the [POLICIES doc](https://github.com/exercism/java/blob/master/POLICIES.md#starter-implementations) for an explanation of when you need to add a starter implementation.
166
 
166
 
167
+4. Check if there is canonical data for the exercise you're adding.
168
+This can be found at `https://github.com/exercism/problem-specifications/tree/master/exercises/EXERCISE-SLUG/canonical-data.json`.
169
+If there is canonical data for your exercise then you should follow this when making the tests.
170
+We aim to follow the canonical data as closely as possible in our tests to ensure thorough test coverage.
171
+If there is canonical data available you also need to create a file at `exercises/exercise-slug/.meta/version` specifying the canonical data version (e.g. `1.0.0`).
172
+The canonical data version can be found at the top of the canonical data file for that exercise.
173
+See other exercises, e.g. [acronym](https://github.com/exercism/java/tree/master/exercises/acronym/.meta), for an example `version` file.
174
+
167
 Hopefully that should be enough information to help you port an exercise to the Java track.
175
 Hopefully that should be enough information to help you port an exercise to the Java track.
168
 Feel free to open an issue or post in the [Gitter exercism/java room](https://gitter.im/exercism/java) if you have any questions and we'll try and answer as soon as we can.
176
 Feel free to open an issue or post in the [Gitter exercism/java room](https://gitter.im/exercism/java) if you have any questions and we'll try and answer as soon as we can.