DOC: Document how numpy deprecations are treated with static typing #20836

Currently all deprecations are treated as if they're completed in the typing stub files, causing type checkers to produce warnings when using deprecated functions/arguments similar to how DeprecationWarnings are issued during runtime. This behavior is not documented anywhere though and could use a paragraph or two in the typing docs.