Comment 6 for bug 452430

The */docs/* are shipped in the upstream tarball as source restructured text *.rst, which are converted by sphinx to *.html. Debian and Ubuntu ignore the shipped *.html files and use sphinx at build time to regenerate them from the source *.rst files. I don't know if this is a Debian policy, but besides as the upstream author I would also recommend it to ensure the html files are always up to date. (As a human being I might forget to update the html files before doing a release.)

The diff we are seeing here affects only the */docs/build/html/* files, which are ignored by Debian/Ubuntu, but not the */docs/source/*.rst files which are used by Debian and Ubuntu. So this diff does not matter for Debian and Ubuntu at all.

If you would be curious why the html changes and not the rst source files, this is because the html uses now a left navigation sidebar instead of a right navigation sidebar which affects the html code (but not the rst source). But again, this is of no value for Ubuntu.