1739488 - Recent docs builds on bmo.readthedocs.org are failing due to new docutils being incompatible with older Sphinx

Status: RESOLVED FIXED

(bugzilla.mozilla.org :: Documentation, defect)

Description

[David Lawrence [:dkl]]

Error:
Exception occurred:
File "/home/docs/checkouts/readthedocs.org/user_builds/bmo/envs/1765/lib/python2.7/site-packages/sphinx/util/nodes.py", line 94, in apply_source_workaround
for classifier in reversed(node.parent.traverse(nodes.classifier)):
TypeError: argument to reversed() must be a sequence

Upstream discussions:
https://github.com/readthedocs/readthedocs.org/issues/8616
https://github.com/readthedocs/readthedocs.org/issues/8642

Note:
We need to create a .readthedocs.yaml file that specify versions per
https://github.com/sphinx-doc/sphinx/issues/9783#issuecomment-952950115

Comment 1

[David Lawrence [:dkl]]

Thanks for the review. Merged to master.
https://github.com/mozilla-bteam/bmo/commit/64168956e2f72e22895d2cd869a0569c4b5c3967