Add a section "Stub package versioning" - #10840

Any suggestions welcome!

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

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.

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

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 :/

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.