Put appropriate "(Why?)" links in the user guide as we did for the javadoc about jspecify HOT 3 OPEN

Thanks for the feedback! I'd like to make sure we have enough "(Why?)" breadcrumbs in the various documents to point people to the FAQ. You can see a few of those in the javadoc. I'll make this issue about doing that in the user guide too.

from jspecify.

(For the record Chris :-) the Design FAQ is also linked from the start-here page but it's very easy for the eyes to pass over that part.)

As for a comprehensible explanation of where <T extends @Nullable Object> comes from, the "understanding the null-aware type system" doc will try to tackle that. Its early unsatisfactory form is [here](https://github.com/jspecify/jspecify/wiki/null-aware-type-system .. I will work more on it, give it some diagrams and so forth.

from jspecify.

You can find a little discussion of that in the design FAQ, which is currently linked from the bottom of one page in the general FAQ in the wiki. It's definitely going to need to be somewhere more prominent someday :)

For the Consumer question, see #72. [edit: tl;dr "Not yet, maybe someday."]

from jspecify.