Currently lots of methods within the Bukkit API can return null under certain valid conditions; these conditions are normally documented within the javadocs of each method (e.g. most methods within ConfigurationSection).

However javadocs cannot be accessed for static code analyses. Therefore it would be massively helpful if all methods that may return null could be annotated with the javax.annotation.Nullable annotation which can be used by such tools.

The javax.annotation package is already present within Bukkit's dependencies. The change would not break any existing API usage.