Description
Noticed that docs weren't building on readthedocs, with an error of:
Traceback (most recent call last):
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/sphinx/cmd/build.py", line 280, in build_main
app.build(args.force_all, filenames)
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/sphinx/application.py", line 348, in build
self.builder.build_update()
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/sphinx/builders/init.py", line 299, in build_update
len(to_build))
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/sphinx/builders/init.py", line 361, in build
self.write(docnames, list(updated_docnames), method)
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/sphinx/builders/init.py", line 535, in write
self._write_serial(sorted(docnames))
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/sphinx/builders/init.py", line 545, in _write_serial
self.write_doc(docname, doctree)
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/sphinx/builders/html/init.py", line 596, in write_doc
self.docwriter.write(doctree, destination)
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/docutils/writers/init.py", line 78, in write
self.translate()
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/sphinx/writers/html.py", line 71, in translate
self.document.walkabout(visitor)
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/docutils/nodes.py", line 199, in walkabout
if child.walkabout(visitor):
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/docutils/nodes.py", line 199, in walkabout
if child.walkabout(visitor):
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/docutils/nodes.py", line 191, in walkabout
visitor.dispatch_visit(self)
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/sphinx/util/docutils.py", line 468, in dispatch_visit
method(node)
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/sphinx/writers/html5.py", line 357, in visit_title
super().visit_title(node)
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/docutils/writers/_html_base.py", line 1661, in visit_title
start_tag, close_tag = self.section_title_tags(node)
File "/home/docs/checkouts/readthedocs.org/user_builds/xga/envs/latest/lib/python3.7/site-packages/docutils/writers/html5_polyglot/init.py", line 445, in section_title_tags
if (ids and self.settings.section_self_link
AttributeError: 'Values' object has no attribute 'section_self_link'
When I look at the logs the failing ones are using docutils v0.18, and ones that worked are using v0.17. Doesn't take a genius to figure out that there is something wrong there.
I will move from specifying docutils > v0.11 to specifying that v0.17 is the one I want.