As an experiment, I tried using @Nullable and @Nonnull to specify the null typing of methods of our APIs and ... I don't hate the results.

This is useful:

1. as documentation / specification (in some cases, we're not very explicit)
2. for tools like IntelliJ which are able to use these annotations to analyze client code