Documentation building fails with AssertionError while writing internals/contributing/triaging-tickets

[Giovanni Mariani]

Trying to package Django for Rosa Linux Fresh R10 (a Mandriva derivative), using sphinx 1.4.9.
The build of Django docs ("make -C docs/ html") fails while writing internals/contributing/triaging-tickets whit this error message:
Exception occurred:
File "/usr/lib/python2.7/site-packages/docutils/writers/_html_base.py", line 735, in depart_document assert not self.context, 'len(context) = %s' % len(self.context)
AssertionError: len(context) = 1

The issue is present in 1.8.19 and 1.11.12, with python 2.7, as well in 2.0.4, with python 3.5.
Attached full log of a 1.11.2 failed build and corresponding sphinx traceback.

[Giovanni Mariani]

Trace back of a failed build from sphinx

[Giovanni Mariani]

Edited build log of a failed build

[Claude Paroz]

My suspicion while reading the error log is that Sphinx is choking on the documentation example headers in the writing-documentation.txt content.
Did you try with another Sphinx version? I don't remember having been faced with such an error (I'm using Sphinx 1.7.0 currently).

[Tim Graham]

I don't think we'll spend any time to fix issues with older sphinx versions. The issue seems fixed as of sphinx 1.5.1.