[Python-ideas] Make Python 2.7’s online docs optionally redirect to Python 3 online docs

Terry Reedy tjreedy at udel.edu
Thu Mar 7 17:53:58 EST 2019


On 3/7/2019 8:56 AM, Steven D'Aprano wrote:
> On Thu, Mar 07, 2019 at 08:10:20AM -0500, James Lu wrote:
> 
>> Rationale: When I use a search engine to google a Python question, I
>> frequently get a link to a page of the Python 2.7 documentation that
>> shows before the Python 3 documentation link.
>>
>> This is annoying and slows down my programming.
> 
> Please see
> 
> https://bugs.python.org/issue35435
> 
> and related links from that issue.
> 
> I've found that the search engines are getting better at linking to the
> more recent docs. For example, all of these:
> give me Python 3 first and Python 2 second.

> https://duckduckgo.com/?q=python+docs+random
> 
> https://search.yahoo.com/yhs/search?p=python+docs+itertools
> 
> https://www.bing.com/search?q=python+docs+netrc
> 
> https://www.startpage.com/do/search?q=python+docs+array

Ditto for me: /3/ before /2/.

> https://www.dogpile.com/serp?q=python+docs+shutil

I get /2/ before /3/

  Even the comparatively
> obscure "sndhdr" module gets Python 3 first:
> https://www.google.com/search?q=python+docs+sndhdr

Ditto, but no /2/ on first page.

> However these gives Python 2 first:
> 
> https://www.startpage.com/do/search?q=python+docs+netrc

/2/ followed by /3.1.5/.  No /3/ on first page, so no option to 
influence better placement of /3/.

> https://www.dogpile.com/serp?q=python+docs+fileinput

I get /3/ before /2/.  Does order depend on country?  (AU versus US)

> But note that the docs do include a drop down menu to select the
> version, so it shouldn't be that difficult to swap from old versions to
> the most recent.
> 
> (Unless you're looking at *really* old versions like 1.5.)
> (Or 3.1.5 ;-)


-- 
Terry Jan Reedy



More information about the Python-ideas mailing list