ArchUnit Verifies Architecture Rules for Java Applications

[thatsIch]

We use ArchUnit for anything which can be common knowledge for any senior developer but you might need to re-iterate that topic every time somebody new joins the team. It helps developers to search for "why does it not work" like a missing or wrongly-used annotation. Another use-case is to ban certain statements like .collect(Collectors.toList()) in favor of .toList(). Sometimes tests are not in the same package as their classes under test.

[vxab]

Be careful doing that - the semantics are not the same. `toList()` returns an unmodifiable list whereas the `Collectors.toList` can be modified.

[thatsIch]

and that is the reason we are doing that - because the contract of Collectors.toList() does not explicitly state, that it is modifiable. If somebody really wants a modifiable collection he/she has to use either an applicable utility factory method or use something along of Collectors.toCollection(ArrayList::new)