improvement of instructions to implement a new exercise

mirkoperillo · mirkoperillo · commit 2dee3d437df9 · 2021-01-30T15:05:29.000+01:00
* improve instructions to implement a new exercise

* improve description
diff --git a/reference/implementing-a-concept-exercise.md b/reference/implementing-a-concept-exercise.md
@@ -60,31 +60,40 @@ languages
 
 ## Step 1: Add code files
 
-The configuration files may be copied from another exercise. We aim to keep these in sync:
+The configuration files may be copied from another exercise. We aim to keep these in sync. We suggest to use:
 
-- `build.gradle`
+- `languages/java/exercises/concept/basics/build.gradle`
 
 Now create the following three files:
 
 - `src/main/java/<slug>.java`. the stub implementation file, which is the starting point for students to work on the exercise.
-- `src/test/java/<slug>Test.java`: the test suite.
+- `src/test/java/<slug>Test.java`: the test suite, please use `assertj` to describe assertions instead of those offered by JUnit.
 - `.meta/example/src/main/java/<slug>.java`: an example implementation that passes all the tests.
 
-## Step 2: Add documentation files
+Append to `languages/java/exercises/settings.gradle` the following line: `concept:<slug>`
+
+## Step 2: Validate the solution
+
+Before submitting your solution, be sure it works following these two steps from the folder of your exercise:
+
+1. Test the solution running `gradle test`
+2. Validate the coding style running `gradle check`
+
+## Step 3: Add documentation files
 
 How to create the files common to all tracks is described in the [how to implement a concept exercise document][how-to-implement-a-concept-exercise].
 
-## Step 3: Update list of implemented exercises
+## Step 4: Update list of implemented exercises
 
 - Add the exercise to the [list of implemented exercises][implemented-exercises].
 
-## Step 4: Add analyzer (optional)
+## Step 5: Add analyzer (optional)
 
 Some exercises could benefit from having an exercise-specific [analyzer][analyzer]. If so, specify what analysis rules should be applied to this exercise and why.
 
 _Skip this step if you're not sure what to do._
 
-## Step 5: Add representation (optional)
+## Step 6: Add representation (optional)
 
 Some exercises could benefit from having an custom representation as generated by the [Java representer][representer]. If so, specify what changes to the representation should be applied and why.
 
