Take the Javadoc warning down a notch

[kevinb9n]

Currently we have

Warning: These annotations are under development, and any aspect of their naming, locations, or design is subject to change until the JSpecify 1.0 release. Moreover, supporting analysis tools will be tracking the changes on varying schedules. Releasing a library using these annotations in its API is strongly discouraged at this time.

This seems overstated at this point, yes?

[kevinherron]

I was just about to ask about this. On the repo home page / README you have:

Version 0.3 is relatively safe to depend on in your code. Or you can read a more detailed answer.

But then I read the Javadoc and started to question whether it's time yet.

Is there somewhere I can read about the remaining obstacles to a 1.0 version?

[kevinb9n]

Glad you're interested! You can filter issues by the 1.0 milestone. That should at least trend toward accurate.

However, there is an ambiguity between the jar going 1.0 and the spec going 1.0; there are several minor changes that can happen to the latter without any effect on the former. I'm not sure if we accounted for that in how we apply the milestone to issues.

[kevinb9n]

For this issue I set the milestone to 1.0 but it's actually "the sooner the better", doesn't need to wait.

[kevinb9n]

Honestly, what happens if we just remove this warning completely?

[kevinherron]

Honestly, what happens if we just remove this warning completely?

More users? 🙃

[kevinb9n]

Oh, never mind then. 🤣

[agentgt]

That warning btw I have seen cited on reddit and various places and the general outcome seems to be unfavorable inhibition even for library authors like myself.

Anyway I'm for more users 😄

[woj-tek]

So my 3¢: I was just thinking about using nullness annotations and wanting to go with something standard but after reading both readme and wiki I wasn't so sure. Then I looked at milestone for 1.0 which sits at ~50% so from the cursory look it's really hard to figure out if one should adopt it or not.

Alas, it seems that 1.0 is closer than further so it should be OK to adopt it :-)