warnerrors = True no longer works with Sphinx < 1.3, and this
makes warnings fail silently [2].
A patch [1] is out to fix that, and until pbr releases we will
have to be careful not to bitrot.
This patch fixes the outstanding link error and tweaks the wording
of the affected pill of wisdom.
[1] I680b448471e687919d202e8f2abe57f8ba3b22ee
[2] bug #
1496882
Change-Id: Id9cce7ae78c51dceeb56c6b5b8b04340c5378748
In fact, when the built-in open method is mocked during tests, some
utilities (like debtcollector) may still rely on the real thing, and may
end up using the mock rather what they are really looking for. If you must,
- consider scoping by `module https://review.openstack.org/#/c/232265/`_, but
+ consider using `OpenFixture <https://review.openstack.org/#/c/232716/>`_, but
it is better not to mock open() at all.