[doc]: Spotted errors while working on rstlint. (GH-30879)

Also ignored some `make suspicious` false positives while assuring
true positives were properly seen by rstlint.