DOC: fix formatting / links of API refs in 1.0.2 whatsnew
cc @TomAugspurger (did a few other clean-ups directly as well)
Thanks. Owee, I'm MrMeeseeks, Look at me.

There seem to be a conflict, please backport manually. Here are approximate instructions:

1. Checkout backport branch and update it.

```
$ git checkout 1.0.x
$ git pull
```

2. Cherry pick the first parent branch of the this PR on top of the older branch:
```
$ git cherry-pick -m1 c1fd95bece36815d7b3fa09f1e103a5218c5f5e9
```

3. You will likely have some merge/cherry-pick conflict here, fix them and commit:

```
$ git commit -am 'Backport PR #32620: DOC: fix formatting / links of API refs in 1.0.2 whatsnew'
```

4. Push to a named branch :

```
git push YOURFORK 1.0.x:auto-backport-of-pr-32620-on-1.0.x
```

5. Create a PR against branch 1.0.x, I would have named this PR:

> "Backport PR #32620 on branch 1.0.x"

And apply the correct labels and milestones.

Congratulation you did some good work ! Hopefully your backport PR will be tested by the continuous integration and merged soon!

If these instruction are inaccurate, feel free to [suggest an improvement](https://github.com/MeeseeksBox/MeeseeksDev).
                 I'll backport this manually.