[issue8040] It would be nice if documentation pages linked to other versions of the same document

Daniel Stutzbach report at bugs.python.org
Sat Jul 10 14:16:55 CEST 2010


Daniel Stutzbach <daniel at stutzbachenterprises.com> added the comment:

On Sat, Jul 10, 2010 at 1:56 AM, Terry J. Reedy <report at bugs.python.org>wrote:

> I think this effectively impossible for volunteers. Microsoft has 1000s of
> paid employees. Chapter and Sections numbers do not match from version to
> version.
>

We don't need to match numbers, we just need to match links, which in 99% of
all cases follow a regular pattern:

For example:

http://docs.python.org/py3k/library/fractions.html
http://docs.python.org/library/fractions.html
http://docs.python.org/release/2.6.5/library/fractions.html

It's pretty easy to generate the links to the corresponding pages.  The
trickier part is testing that the link is valid when building the pages.

In an ideal universe, there would be a way to manually specify when a page
has been renamed (e.g., _winreg -> winreg), but even if those links were
missing it would still be quite useful (IMO, of course).

How many other versions would you link to? Multiple links could get a bit
> ugly.
>

The same number as currently listed in the sidebar on the index page.

----------
status: pending -> open
Added file: http://bugs.python.org/file17926/unnamed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue8040>
_______________________________________
-------------- next part --------------
<div class="gmail_quote">On Sat, Jul 10, 2010 at 1:56 AM, Terry J. Reedy <span dir="ltr">&lt;<a href="mailto:report at bugs.python.org" target="_blank">report at bugs.python.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

I think this effectively impossible for volunteers. Microsoft has 1000s of paid employees. Chapter and Sections numbers do not match from version to version.<br></blockquote><div><br></div><div>We don&#39;t need to match numbers, we just need to match links, which in 99% of all cases follow a regular pattern:</div>

<div><br></div><div>For example:</div><div><br></div><div><a href="http://docs.python.org/py3k/library/fractions.html" target="_blank">http://docs.python.org/py3k/library/fractions.html</a></div><div><a href="http://docs.python.org/library/fractions.html" target="_blank">http://docs.python.org/library/fractions.html</a></div>

<div><a href="http://docs.python.org/release/2.6.5/library/fractions.html" target="_blank">http://docs.python.org/release/2.6.5/library/fractions.html</a></div><div><br></div><div>It&#39;s pretty easy to generate the links to the corresponding pages.  The trickier part is testing that the link is valid when building the pages.</div>

<div><br></div><div>In an ideal universe, there would be a way to manually specify when a page has been renamed (e.g., _winreg -&gt; winreg), but even if those links were missing it would still be quite useful (IMO, of course).</div>
<div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
How many other versions would you link to? Multiple links could get a bit ugly.<br></blockquote><div><br></div><div>The same number as currently listed in the sidebar on the index page.</div></div>


More information about the Python-bugs-list mailing list