Skip to content

Commit a807692

Browse files
authored
POLICIES.md: update good first issue, starter impl
Adds more explanation concerning the starter implementation policy closes exercism#1669
1 parent e5568cc commit a807692

1 file changed

Lines changed: 8 additions & 7 deletions

File tree

POLICIES.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,8 @@ Our policies are not set-in-stone. They represent directions chosen at a point i
1919
|:------------|:-----------------|
2020
| Exercise added/updated | [Prefer instance methods](#prefer-instance-methods); [Avoid using final](#avoid-using-final); [Adhere to best practices](#adhere-to-best-practices); [Starter implementations](#starter-implementations); [Ignore noninitial tests](#ignore-noninitial-tests); [Multiple file submissions](#multiple-file-submissions); [Name test class after class under test](#name-test-class-after-class-under-test); [Add hint for the first exercises without starter implementation](#add-hint-for-the-first-exercises-without-starter-implementation); [Reference tutorial in the first exercises](#reference-tutorial-in-the-first-exercises); [Avoid returning null](#avoid-returning-null); [Use ExpectedException](#use-expectedexception)
2121
| Track rearranged | [Starter implementations](#starter-implementations); [Multiple file submissions](#multiple-file-submissions) |
22-
| New issue observed in track | [Good first patches](#good-first-patches) |
23-
| "Good first patch" issue completed | [Good first patches](#good-first-patches) |
22+
| New issue observed in track | [Good first issues](#good-first-issues) |
23+
| "Good first issue" issue completed | [Good first issues](#good-first-issues) |
2424
| Installing Java instructions updated | [Simple onboarding](#simple-onboarding) |
2525

2626
## Policy Descriptions
@@ -33,7 +33,8 @@ References: [[1](https://github.com/exercism/java/issues/177#issuecomment-261291
3333

3434
### Starter implementations
3535

36-
> - Exercises of difficulty 4 or lower: provide stubs for all required constructors and methods. Stubs should include the following body:
36+
> - 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.
37+
Stubs should include the following body:
3738
`throw new UnsupportedOperationException("Delete this statement and write your own implementation.");`
3839
> - Exercises of difficulty 5 or higher: provide no stubs by default, but 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.
3940
@@ -47,7 +48,7 @@ References: [[1](https://github.com/exercism/java/issues/178)], [[2](https://git
4748

4849
> Ensure that all Java code adheres to the best practices listed below:
4950
> - Minimize the accessibility of classes and members ([Effective Java, item 13](http://jtechies.blogspot.com/2012/07/item-13-minimize-accessibility-of.html))
50-
> - Always use curly brackest in if statements. This makes your code easier to maintain and easier to read ([Oracle style guide, item 7.4](http://www.oracle.com/technetwork/java/javase/documentation/codeconventions-142311.html#431))
51+
> - Always use curly brackets in `if statements`. This makes your code easier to maintain and easier to read ([Oracle style guide, item 7.4](http://www.oracle.com/technetwork/java/javase/documentation/codeconventions-142311.html#431))
5152
```java
5253
// Please do this
5354
if (condition) {
@@ -86,11 +87,11 @@ References: [[1](https://github.com/exercism/java/issues/101#issuecomment-249349
8687
8788
References: [[1](https://github.com/exercism/java/issues/365#issuecomment-292533120)]
8889

89-
### Good first patches
90+
### Good first issues
9091

91-
> Aim to keep 10-20 small and straightforward issues open at eny given time. Identify any such issues by applying the "Good first patch" label. You can view the current list of these issues [here](https://github.com/exercism/java/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+patch%22).
92+
> Aim to keep 10-20 small and straightforward issues open at any given time. Identify any such issues by applying the "good first issue" label. You can view the current list of these issues [here](https://github.com/exercism/java/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).
9293
93-
References: [[1](https://github.com/exercism/java/issues/220#issue-196447088)]
94+
References: [[1](https://github.com/exercism/java/issues/220#issue-196447088)], [[2](https://github.com/exercism/java/issues/1669)]
9495

9596
### Simple onboarding
9697

0 commit comments

Comments
 (0)