#16933 closed Cleanup/optimization (fixed)
Make it more obvious on screen which version of the doc is being viewed
| Reported by: | Julien Phalip | Owned by: | nobody |
|---|---|---|---|
| Component: | *.djangoproject.com | Version: | 1.3 |
| Severity: | Normal | Keywords: | |
| Cc: | Triage Stage: | Accepted | |
| Has patch: | no | Needs documentation: | no |
| Needs tests: | no | Patch needs improvement: | no |
| Easy pickings: | no | UI/UX: | yes |
Description
This came up as the same (invalid) doc bug in the tutorial was reported multiple times within just a few days (#16868, #16890 and #16932), likely because the reporters were looking at the wrong version of the documentation. This doesn't only affect newbies as I've also recently heard from an experienced Django developer that he got excited about a documented feature that he later realised he couldn't use in his environment because that feature hadn't been released yet (he was looking at the DEV doc without knowing). It's quite easy to get bitten by this, especially if you use Google to search the doc.
One possible fix would be to add a nifty little block "DEV version" or "1.3 version" with a fixed position (e.g. stuck to the top of the viewport) as you scroll down the page.
I'm choosing the component "Djangoproject.com Web site" (and not "Documentation") since this is where the change needs to happen, i.e. in: https://github.com/django/djangoproject.com
Change History (3)
comment:1 by , 13 years ago
comment:2 by , 13 years ago
| Resolution: | → fixed |
|---|---|
| Status: | new → closed |
This is now fixed. Check out the little green box in the bottom right corner: https://docs.djangoproject.com
comment:3 by , 13 years ago
Although this was implemented, I didn't see it and spent 4 hours figuring out why the tutorial code wasn't working for me (I was using Django 1.3.1 but looking at the tutorial for the dev version). In case someone else comes across this, here's a screenshot showing the little green box with the version, which you can click on to select a different version:
And #16954 was another one...