Add a section "Stub package versioning"

[srittau]

No description provided.

[srittau]

Any suggestions welcome!

This will of course need an update if the discussion in #10837 concludes that we update our versioning scheme.

[AlexWaygood]

Could we also explicitly recommend against using mypy's --install-types option (and especially not --install-types --non-interactive)? The behaviour of --install-types #10825 (comment) is... quite bad.

I guess it's not ideal for us to single out a specific option for a specific type checker, but it is still the most widely used type checker.

[srittau]

Isn't --install-types something that mypy should document better? Maybe even issue a warning when it's used? Otherwise, any wording suggestions welcome!

[AlexWaygood]

Isn't --install-types something that mypy should document better? Maybe even issue a warning when it's used? Otherwise, any wording suggestions welcome!

Yes. It's unfortunately very widely used, however, so I think there'd be an outcry if mypy even tried to deprecate it :/

[AlexWaygood]

Overall, this looks great! A few wording suggestions:

[AlexWaygood]

This is great. Thanks!

[hauntsaninja]

(A little late to this, so I haven't read the existing resolved comments)

Thank you for documenting this!

[srittau]

I think I integrated all comments, but I wouldn't be surprised if there's still a lot of fine-tuning possible in future PRs.