use jakarta.annotation to document nullability of APIs

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