Просмотр исходного кода

Update policy around language constructs

Stuart Kent 9 лет назад
Родитель
Сommit
ae5e45a673
1 измененных файлов: 4 добавлений и 2 удалений
  1. 4
    2
      POLICIES.md

+ 4
- 2
POLICIES.md Просмотреть файл

@@ -40,9 +40,11 @@ References: [[1](https://github.com/exercism/java/issues/177#issuecomment-261291
40 40
 
41 41
 References: [[1](https://github.com/exercism/java/issues/178)], [[2](https://github.com/exercism/java/pull/683#discussion_r125506930)]
42 42
 
43
-### Do not make user-facing classes `final`
43
+### Minimize initial complexity in user-facing code
44 44
 
45
-> Starter implementations and test classes should not include the `final` keyword in class declarations as it isn't strictly necessary and could be confusing to people unfamiliar with Java.
45
+> Minimize (within reason) the number of Java language constructs a user is exposed to simultaneously at the beginning of the track. Instead, introduce those constructs with examples and hints in an appropriate later exercise. Specific applications of this policy include:
46
+> - avoiding use of the `public` keyword in user-facing class declarations, method signatures, and parameter signatures;
47
+> - avoiding use of the `final` keyword in user-facing class declarations, method signatures, and parameter signatures.
46 48
 
47 49
 ### Ignore noninitial tests
48 50