This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author jaraco
Recipients docs@python, jaraco
Date 2019-05-08.16:03:27
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1557331408.26.0.606381835406.issue36853@roundup.psfhosted.org>
In-reply-to
Content
In working on some docs contributions, I've run into issues where docs builds are failing in CI differently than they're failing locally.

Locally, running `make venv` from `Docs/` results in Sphinx 2, whereas on Azure Pipelines, the docs are built with Sphinx 1.8.2 (https://github.com/python/cpython/blob/1d4b16051f8550fd7dada3670a3e83ae13b99d3b/.azure-pipelines/docs-steps.yml#L15).

When running with Sphinx 2, this error emerges when running `make suspicious` when a change is around that triggers suspicious code (such as this commit https://github.com/python/cpython/pull/12547/commits/9bde7faf6f051d4a7306ac8629d915ce069392f7):

Exception occurred:
  File "/Users/jaraco/code/public/cpython/Doc/tools/extensions/suspicious.py", line 154, in report_issue
    self.warn('[%s:%d] "%s" found in "%-.120s"' %
AttributeError: 'CheckSuspiciousMarkupBuilder' object has no attribute 'warn'

First, we probably want to make these processes consistent (define the dependencies in exactly one place).

Second, we should probably determine why the doc builds are failing on Sphinx 2 and update the `suspicious` code to support Sphinx 2.
History
Date User Action Args
2019-05-08 16:03:28jaracosetrecipients: + jaraco, docs@python
2019-05-08 16:03:28jaracosetmessageid: <1557331408.26.0.606381835406.issue36853@roundup.psfhosted.org>
2019-05-08 16:03:28jaracolinkissue36853 messages
2019-05-08 16:03:27jaracocreate