Issue 25113: documentation version switcher is broken (original) (raw)

Issue25113

Created on 2015-09-14 19:32 by yselivanov, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Messages (8)
msg250700 - (view)	Author: Yury Selivanov (yselivanov) *	Date: 2015-09-14 19:32
The dropdown that allowed to switch the Python version for docs disappeared with py3.5 release.
msg250702 - (view)	Author: Berker Peksag (berker.peksag) *	Date: 2015-09-14 20:44
Looks like version_switch.js is not included into HTML. SPHINXOPTS='-A versionswitcher=1' make -C Doc/ htmlview works for me locally on the 3.5 branch. Perhaps 3.5 docs were created manually or without running "make autobuild-{dev,html,stable}"?
msg250730 - (view)	Author: Larry Hastings (larry) *	Date: 2015-09-15 08:02
When I built the documentation, I used % release.py --export 3.5.0 (release.py coming from hg.python.org/release, a collection of release manager tools.) I then installed this build as the 3.5.0 documentation, specifically the build from "python-3.5.0-docs-html.tar.bz2". I do that so that people don't complain "hey the documentation is out of date!" when the release goes live. I wouldn't be surprised if the version picker is suppressed in this build, as it's intended to be installed by users. However, there's a cron job that rebuilds the documentation automatically. I'm not sure how often, but I think it's every couple of hours. That build process, whatever it is, should definitely enable the version picker. Normally the cron job would have overwritten the docs by now. However I just discovered I left the docs non-group-writeable when I installed them, which meant the cron job couldn't overwrite them. I just fixed that, and hopefully within a couple of hours the cron job will awake from its slumber and overwrite everything. tl;dr: Hopefully it'll silently fix itself sometime today.
msg250732 - (view)	Author: Georg Brandl (georg.brandl) *	Date: 2015-09-15 08:07
NM.
msg250788 - (view)	Author: Berker Peksag (berker.peksag) *	Date: 2015-09-15 17:47
> tl;dr: Hopefully it'll silently fix itself sometime today. Yes, it's working now. Thanks for the explanation.
msg250851 - (view)	Author: Yury Selivanov (yselivanov) *	Date: 2015-09-16 16:12
The switcher isn't visible on all pages, I suspect we need to bust caches on cdns/varnish
msg250855 - (view)	Author: Ned Deily (ned.deily) *	Date: 2015-09-16 17:04
We are pursuing the stale CDN cache issue with #python-infra. It appears that, as it stands, the cached doc pages will expire within a week.
msg250862 - (view)	Author: Mark Lawrence (BreamoreBoy) *	Date: 2015-09-16 20:13
This wasn't working for me earlier but it is now at 21:11 BST so I'd assume we can leave this closed.