Java Idioms - raisercostin/software-wiki GitHub Wiki

Never use java keyword assert (except you really know what you're doing) - the code sometimes doesn't run, is perceived as a non-deterministic program by a normal user.
for a method: input parameters should't be Try[X], output parameters can be Try[X]. Basically you want the caller to treat the special cases and not let the method to handle/interpret that.