On 5/21/2012 2:28 AM, Nick Coghlan wrote:
On Mon, May 21, 2012 at 3:47 PM, Terry Reedy<tjre...@udel.edu> wrote:
What might be useful is to have the 'Other versions' links on the left
margin of *every* page, not just the front page, but have them link to the
corresponding page of the other docs (if there is one, and non-trivial I
expect). For someone trying to write combined 2/3 code, or merely to learn
the other version, I would think it useful to be able to jump to the
corresponding page for the other version.
That's what the Django widget does. I'm not talking about their search
form - I'm talking about the floating CSS box that appears in the
bottom right of each page and stays there as you scroll down. If you
click on it, the list of available documentation versions appears,
with direct links to the corresponding page in the other versions.
It has several attractive features:
- always present, even when you scroll down on a long page
- unobtrusive when you don't need it (only displays current version by
default, have to click it to get the list of all versions)
- direct links to the corresponding page in other versions
I see it now. Very nice. I hope our doc people can duplicate it.
--
Terry Jan Reedy
_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe:
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
