DOC: fixup new doc build warnings after PR 25946

There are some new warnings, typos, and formatting fixes needed, see the comments starting https://github.com/numpy/numpy/pull/25946#pullrequestreview-1920361630