This commit updates the tox 'docs' environment to also run our specs
tests, so that the existing docs gate merge jobs will catch any specs
that get added but don't follow the template.
This commit also updates the specs test to suppress warnings for
:doc: references in specs.