You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This updates the policies in regards to hints.md (now
instructions.append.md) and stubs are now generally provided for
the exercises (instead of just the lower difficulty ones).
See also:
- #2133 for when stubs
were added for exercises
- 5261735
for when hints.md became instructions.append.md
> - Exercises of difficulty 4 or lower: provide stubs for all required constructors and methods. This means that you need to provide stubs for those constructors or methods that are necessary to pass all tests. E.g. stubs for private methods may be skipped.
48
-
> Stubs should include the following body:
47
+
> Provide stubs for all required constructors and methods. This means that you need to provide stubs for those constructors or methods that are necessary to pass all tests. E.g. stubs for private methods may be skipped.
48
+
> Stubs should include the following body:
49
49
>
50
-
> ```java
51
-
>thrownewUnsupportedOperationException("Delete this statement and write your own implementation.");
52
-
> ```
53
-
>
54
-
>-Exercises of difficulty 5 or higher: copy the StubTemplate.java file (provided in [this template file](https://github.com/exercism/java/blob/main/resources/exercise-template/src/main/java/ExerciseName.java)) and rename it to fit the exercise. For example, for the exercise linked-list the file could be named LinkedList.java. Then either (1) add hints to the hints.md file (which gets merged into the README.md for the exercise) or (2) provide stubs as above for exercises that demand complicated method signatures.
50
+
> ```java
51
+
>thrownewUnsupportedOperationException("Delete this statement and write your own implementation.");
### Add hint for the first exercises without starter implementation
130
-
131
-
> According to the starter implementation policy, any exercise with difficulty 4 or lower should have starter implementation.
132
-
> Any exercise with difficulty 5 or above will have no starter implementation (unless its signature is very complicated).
133
-
> This could be confusing to users when tackling their first exercise with difficulty 5 when they are used to starter implementation being provided.
134
-
>
135
-
> Therefore a hints.md file should be added to the .meta directory for every exercise with difficulty 5.
136
-
> This file should explain what they need to do when there is no starter implementation.
137
-
> The files should all be the same so you can copy it from any other exercise with difficulty 5, e.g. [flatten-array](https://github.com/exercism/java/tree/main/exercises/pratice/flatten-array/.meta/hints.md).
138
-
>
139
-
> We add the file to every exercise with difficulty 5 because the structure of the track means that we don't know which exercise will be the first one without starter implementation that a user will be faced with.
> The hello world exercise has an extensive tutorial on how to solve exercism exercises.
146
130
> This tutorial would probably be useful to have as a reference when solving some of the other earlier exercises as well.
147
-
> Therefore any exercise with difficulty less than 3 should have a hints.md file which references [the hello world tutorial](https://github.com/exercism/java/blob/main/exercises/practice/hello-world/.docs/instructions.append.md#tutorial).
131
+
> Therefore any exercise with difficulty less than 3 should have a instructions.append.md file which references [the hello world tutorial](https://github.com/exercism/java/blob/main/exercises/practice/hello-world/.docs/instructions.append.md#tutorial).
Note: The PRs in the referenced issue uses hints.md, but this is now instructions.append.md (see [commit 52617354](https://github.com/exercism/java/commit/5261735435192b5b10535b2fcf41c81b638e5de5))
0 commit comments