Login | Register For Free | Help
Search for: (Advanced)

Mailing List Archive: Python: Dev

docs.python.org pointing to Python 3 by default?

 

 

First page Previous page 1 2 Next page Last page  View All Python dev RSS feed   Index | Next | Previous | View Threaded


storchaka at gmail

May 21, 2012, 3:26 AM

Post #26 of 43 (149 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On 18.05.12 21:30, Brian Curtin wrote:
> On May 18, 2012 1:26 PM, "Barry Warsaw" <barry [at] python
> <mailto:barry [at] python>> wrote:
> > At what point should we cut over docs.python.org
> <http://docs.python.org> to point to the Python 3
> > documentation by default?
>
> Today sounds good to me.

Yesterday. ;-) Issue14469.

_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


g.brandl at gmx

May 21, 2012, 4:42 AM

Post #27 of 43 (150 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On 05/21/2012 11:09 AM, Łukasz Langa wrote:
> Wiadomo¶æ napisana przez Nick Coghlan w dniu 21 maj 2012, o godz. 09:24:
>
>> The following
>> would be using docs.python.org as a namespace (and is what I think we
>> should move towards):
>>
>> docs.python.org/latest
>> docs.python.org/dev
>> docs.python.org/3.2
>> docs.python.org/3.1
>> docs.python.org/2.7
>> docs.python.org/2.6
>
> Love it. +1

Apart from the "latest" one, all these URLs already work.

Of course, /2.7 is redirected to /, and /3.3 to /dev, etc.
If required, the direction of these redirects can be changed, so
that e.g. / goes to /2.7.

What about:

* Canonical:

docs.python.org/2/
docs.python.org/3/

for latest versions of 2.x and 3.x

docs.python.org/2.7/ etc.

for latest minor versions

docs.python.org/dev/

for latest dev version.

* Redirected:

docs.python.org/ --> either /2/ or /3/ or a "disambiguation page"
docs.python.org/py3k/ -> /3/

There is also /release/X.Y.Z for individual released versions, which
I don't want to change.


I also like Martin's idea of offering more links between individual pages, not
only the front-pages.

Georg

_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


rdmurray at bitdance

May 21, 2012, 5:14 AM

Post #28 of 43 (145 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On Mon, 21 May 2012 11:41:29 +0200, Georg Brandl <g.brandl [at] gmx> wrote:
> On 05/21/2012 03:23 AM, Guido van Rossum wrote:
> > I suggest that we add a separate (virtual) subdomain, e.g. docs3.python.org.
>
> Here are the time machine keys: this subdomain has existed for a few years now :)

The fact that none of us knew about it may say something about its
effectiveness, though.

As long as it does exist, there ought to be a parallel docs2.python.org.

--David
_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


ncoghlan at gmail

May 21, 2012, 5:18 AM

Post #29 of 43 (143 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On Mon, May 21, 2012 at 9:42 PM, Georg Brandl <g.brandl [at] gmx> wrote:
> Apart from the "latest" one, all these URLs already work.

Yeah, I was just extending the scheme I already knew existed :)

> Of course, /2.7 is redirected to /, and /3.3 to /dev, etc.
> If required, the direction of these redirects can be changed, so
> that e.g. / goes to /2.7.
>
> What about:
>
> * Canonical:
>
> docs.python.org/2/
> docs.python.org/3/
>
> for latest versions of 2.x and 3.x
>
> docs.python.org/2.7/ etc.
>
> for latest minor versions
>
> docs.python.org/dev/
>
> for latest dev version.
>
> * Redirected:
>
> docs.python.org/  -->  either /2/ or /3/ or a "disambiguation page"
> docs.python.org/py3k/ -> /3/

Works for me. It also means we're covered if Guido ever finds a reason
to create Python 4000 :)

> I also like Martin's idea of offering more links between individual pages, not
> only the front-pages.

Definite +1 on that. I personally like Django's version selector (for
reasons stated elsewhere in the thread), but anything that makes it
easier to hop between versions would be good.

Cheers,
Nick.

--
Nick Coghlan   |   ncoghlan [at] gmail   |   Brisbane, Australia
_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


guido at python

May 21, 2012, 6:44 AM

Post #30 of 43 (140 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On Sun, May 20, 2012 at 10:47 PM, Terry Reedy <tjreedy [at] udel> wrote:
> On 5/21/2012 12:28 AM, Nick Coghlan wrote:
>>
>> On Mon, May 21, 2012 at 11:23 AM, Guido van Rossum<guido [at] python>
>>  wrote:
>>>
>>> I suggest that we add a separate (virtual) subdomain, e.g.
>>> docs3.python.org.
>
>
> I was about to post the exact same idea.
>
> docs.python.org/py3k is a bit obscure and buried and makes Python 3.x look a
> bit like a second-class citizen on the site. It has previously been our
> policy that each new production-ready release takes 'pride of place' at
> docs.python.org. Not doing so even with 3.3, *and doing nothing else*, could
> be taken as implying that we lack full confidence in the release.
>
> On the other hand, I am sympathetic to Raymond's and Nick's points that
> switching might seem too much 'in their faces' for Py 2 users, especially
> those who do not have or use an offline help file as their everyday
> reference. I want Python 3 to get equal billing, but not to generate
> reaction against it.
>
> I also suggest docs2.python.org as the permanent home for latest python 2
> docs for as long as it seems sensible (probably a decade at least). Make
> that operable now and suggest on the front page of docs.python.org that py2
> users switch before 3.4.
>
>
>> Rather than a new subdomain, I'd prefer to see a discreet
>> "documentation version" CSS widget, similar to that used in the Django
>> docs (see https://docs.djangoproject.com/en/1.4/) that indicated the
>> current displayed version and provided quick links to the 2.7 docs,
>> the stable 3.x docs and the development docs.
>
>
> Each page of our docs say "Python 3.3.0a3 Documentation", or the equivalent,
> at the top. So we already have that covered. The drop-down version selection
> box on the django page seems to only apply to searches. Merely selecting a
> different version does not trigger anything.
>
> 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.

Right. I don't think new subdomains and the improvements that Nick
suggests are incompatible. docs2 and docs3 can just redirect to to
docs/<some version>. It's just that docs2 and docs3 make it easier to
type or link to the (super-major) version you care about. (docs2
should be an alias for 2.7; docs3 for the latest released 3.x
version.)

--
--Guido van Rossum (python.org/~guido)
_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


dmalcolm at redhat

May 21, 2012, 8:19 AM

Post #31 of 43 (140 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On Fri, 2012-05-18 at 14:24 -0400, Barry Warsaw wrote:
> At what point should we cut over docs.python.org to point to the Python 3
> documentation by default? Wouldn't this be an easy bit to flip in order to
> promote Python 3 more better?

If we do, perhaps we should revisit http://bugs.python.org/issue10446

http://hg.python.org/cpython/rev/b41404a3f7d4/ changed pydoc in the py3k
branch to direct people to http://docs.python.org/X.Y/library/ rather
than to http://docs.python.org/library/

This was applied to the 3.2 and 3.1 branches, but hasn't been backported
to any of the 2.* - so if docs.python.org starts defaulting to python 3,
it makes sense to backport that change to 2.*


Hope this is helpful
Dave


_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


g.brandl at gmx

May 21, 2012, 8:50 AM

Post #32 of 43 (139 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On 05/21/2012 02:14 PM, R. David Murray wrote:
> On Mon, 21 May 2012 11:41:29 +0200, Georg Brandl <g.brandl [at] gmx> wrote:
>> On 05/21/2012 03:23 AM, Guido van Rossum wrote:
>> > I suggest that we add a separate (virtual) subdomain, e.g. docs3.python.org.
>>
>> Here are the time machine keys: this subdomain has existed for a few years now :)
>
> The fact that none of us knew about it may say something about its
> effectiveness, though.

Sure. I was never fond of it, but there was a discussion probably similar
to this one, and it was agreed to add that subdomain.

Georg

_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


barry at python

May 21, 2012, 8:51 AM

Post #33 of 43 (137 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On May 20, 2012, at 04:27 PM, Raymond Hettinger wrote:

>When there is more uptake of Python 3, it would be reasonable move.

How do we measure this, and what's the milestone for enough uptake to make
the switch?

Cheers,
-Barry
Attachments: signature.asc (0.82 KB)


tjreedy at udel

May 21, 2012, 8:56 AM

Post #34 of 43 (139 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On 5/21/2012 3:35 AM, Hynek Schlawack wrote:

> Also -1 on docs3, that would suggest that it’s still something special
> and 2 (= docs) is the real deal.

Guido and I are proposing docs2 and docs3 each pointing to the latest
docs for each series. That puts them on equal status.
docs.python.org, besides being a namespace for specific version docs
(/x.y, minus Nick's /latest) would be transitioned away from being a
synonym for docs2. It could become a *neutral* index page listing docs2
and docs3 for the 'latest' production version of each series and then
each subdirectory.

--
Terry Jan Reedy


_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


tjreedy at udel

May 21, 2012, 9:03 AM

Post #35 of 43 (142 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On 5/21/2012 3:24 AM, Nick Coghlan wrote:

> docs.python.org/latest
> docs.python.org/dev
> docs.python.org/3.2
> docs.python.org/3.1
> docs.python.org/2.7
> docs.python.org/2.6
> etc...

This looks great except for 'latest', which is ambiguous and awkward.

Like Guido, I would have docs2 and docs3 link to the latest of each
series. This gives both series equal billing. docs itself could then
become a *neutral* index page. In retrospect, I wish we had done this a
year ago.

This design would continue to work if and when we need docs4.python.org.

--
Terry Jan Reedy

_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


solipsis at pitrou

May 21, 2012, 9:07 AM

Post #36 of 43 (141 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On Mon, 21 May 2012 12:03:31 -0400
Terry Reedy <tjreedy [at] udel> wrote:
> On 5/21/2012 3:24 AM, Nick Coghlan wrote:
>
> > docs.python.org/latest
> > docs.python.org/dev
> > docs.python.org/3.2
> > docs.python.org/3.1
> > docs.python.org/2.7
> > docs.python.org/2.6
> > etc...
>
> This looks great except for 'latest', which is ambiguous and awkward.
>
> Like Guido, I would have docs2 and docs3 link to the latest of each
> series. This gives both series equal billing. docs itself could then
> become a *neutral* index page. In retrospect, I wish we had done this a
> year ago.

I don't like docs2/docs3. First, they are clumsy to type and look
awkward. Second, it's not the right level of segregation; if you wanted
separate domains you'd really want docs.python2.org and
docs.python3.org.

So, in the end, I think the current scheme is ok and we only need to
add a "/stable" pointing to latest 3.x.

Regards

Antoine.


_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


barry at python

May 21, 2012, 9:14 AM

Post #37 of 43 (142 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On May 21, 2012, at 02:28 PM, Nick Coghlan wrote:

>Rather than a new subdomain, I'd prefer to see a discreet
>"documentation version" CSS widget, similar to that used in the Django
>docs (see https://docs.djangoproject.com/en/1.4/) that indicated the
>current displayed version and provided quick links to the 2.7 docs,
>the stable 3.x docs and the development docs.

I'd be all for this, as long as I can still write
chrome/firefox/genericbrowser shortcuts to give me the latest Python 2 or
Python 3 library page.

>I know plenty of people are keen to push the migration to Python 3
>forward as quickly as possible, but this is *definitely* a case of
>"make haste slowly". We need to tread carefully or we're going to give
>existing users an even stronger feeling that we simply don't care
>about the impact the Python 3 migration is having (or is going to
>have) on them. *We* know that we care, but there's still plenty of
>folks out there that don't realise how deeply rooted the problems are
>in Python 2's text model and why the Python 3 backwards compatibility
>break was needed to fix them. They don't get to see the debates that
>happen on this list - they only get to see the end results of our
>decisions. Switching the default docs.python.org version to the 3.x
>series is a move that needs to be advertised *well* in advance as a
>courtesy to our users, so that those that need to specifically
>reference 2.7 have plenty of time to update their links.

Right. I'm just keen on continuing to make progress. I really do think we're
not far from a tipping point on Python 3, and I want to keep nudging us over
the edge. Roller coasters are scary *and* fun. :)

>Back when Python 3 was first released, we set a target for the
>migration period of around 5 years. Since the io performance problems
>in 3.0 meant that 3.1 was the first real production ready release of
>3.x, that makes June 2014 the target date for when we would like the
>following things to be true:

If history is repeated, my guess is that will put us a few months into Python
3.5 development. I think Python 3.3 is shaping up to be a fantastic release,
and once it's out we should start thinking about what we want to accomplish in
Python 3.4 to achieve the goal of Python 3 dominance.

>- all major third party libraries and frameworks support Python 3 (or
>there are Python 3 forks or functional replacements)

There's already great ongoing work on this. It could use more help of course.
I've mentioned Ubuntu's efforts here before, but this is really more about the
greater Python universe, and getting Python 3 on the radar of more and more
projects.

>- Python 3 is the default choice for most new Python projects

When I talk to folks starting new Python projects, I always push for it to
begin in Python 3. Of course, the state of their dependencies is always a
consideration, but this is becoming more feasible for more projects every day.

>- most Python instruction uses Python 3, with Python 2 differences
>described for those that need to work with legacy code
>- (less likely, but possible) user-focused distros such as Ubuntu and
>Fedora have changed their "python" symlink to refer to Python 3

I doubt Debian/Ubuntu will ever switch /usr/bin/python though PEP 394 will
probably have the final word.

>That's still 2 years away, and should line up fairly nicely with the
>release of Python 3.4 (assuming the current release cadence is
>maintained for at least one more version). Key web and networking
>frameworks such as Django [1], Pyramid [2] and Twisted [3] should also
>be well supported on 3.x by that point.

Rough estimate, assuming 18 month cadences and an on-time release of 3.3,
puts 3.4 final in February of 2014.

>>> final33 = datetime.datetime(day=25, month=8, year=2012)
>>> final34 = final33 + datetime.timedelta(days=18 * 30)
>>> final34.isoformat()
'2014-02-16T00:00:00'

Cheers,
-Barry
_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


rdmurray at bitdance

May 21, 2012, 9:15 AM

Post #38 of 43 (142 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On Mon, 21 May 2012 11:19:56 -0400, David Malcolm <dmalcolm [at] redhat> wrote:
> On Fri, 2012-05-18 at 14:24 -0400, Barry Warsaw wrote:
> > At what point should we cut over docs.python.org to point to the Python 3
> > documentation by default? Wouldn't this be an easy bit to flip in order to
> > promote Python 3 more better?
>
> If we do, perhaps we should revisit http://bugs.python.org/issue10446
>
> http://hg.python.org/cpython/rev/b41404a3f7d4/ changed pydoc in the py3k
> branch to direct people to http://docs.python.org/X.Y/library/ rather
> than to http://docs.python.org/library/
>
> This was applied to the 3.2 and 3.1 branches, but hasn't been backported
> to any of the 2.* - so if docs.python.org starts defaulting to python 3,
> it makes sense to backport that change to 2.*

Note that I did apply the fix for 14434 to 2.7. So yes, I think 10446
should be applied to 2.7 as well.

--David
_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


tjreedy at udel

May 21, 2012, 9:18 AM

Post #39 of 43 (146 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On 5/21/2012 7:42 AM, Georg Brandl wrote:
> On 05/21/2012 11:09 AM, Ɓukasz Langa wrote:
>> Wiadomoƛć napisana przez Nick Coghlan w dniu 21 maj 2012, o godz. 09:24:
>>
>>> The following
>>> would be using docs.python.org as a namespace (and is what I think we
>>> should move towards):
>>>
>>> docs.python.org/latest
>>> docs.python.org/dev
>>> docs.python.org/3.2
>>> docs.python.org/3.1
>>> docs.python.org/2.7
>>> docs.python.org/2.6
>>
>> Love it. +1
>
> Apart from the "latest" one, all these URLs already work.
>
> Of course, /2.7 is redirected to /, and /3.3 to /dev, etc.
> If required, the direction of these redirects can be changed, so
> that e.g. / goes to /2.7.
>
> What about:
>
> * Canonical:
>
> docs.python.org/2/
> docs.python.org/3/

If you prefer these to docs2, docs3, OK with me.
Whatever we do, we should encourage book/blog writers to use the
canonical 'latest' links that will not go out of date. So there should
definitely be one for each, with the same format. The exact format is
less important.

> for latest versions of 2.x and 3.x
>
> docs.python.org/2.7/ etc.
>
> for latest minor versions
>
> docs.python.org/dev/
>
> for latest dev version.
>
> * Redirected:
>
> docs.python.org/ --> either /2/ or /3/ or a "disambiguation page"

While I am a strong partisan of Py 3, I do not want Py 2 users to feel
'pushed', so I vote for a neutral index or 'disambiguation' page.

What I would do is set up the canonical pages now. Next, add a notice to
the top of docs.python.org that it will become a neutral index page with
the release of 3.3, so 'please change bookmarks to the new, permanent
page for Py 2', whatever it is.

> docs.python.org/py3k/ -> /3/

> There is also /release/X.Y.Z for individual released versions, which
> I don't want to change.

I would leave those alone too.

--
Terry Jan Reedy


_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


hs at ox

May 21, 2012, 9:25 AM

Post #40 of 43 (140 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

>> Also -1 on docs3, that would suggest that it’s still something special
>> and 2 (= docs) is the real deal.
> Guido and I are proposing docs2 and docs3 each pointing to the latest
> docs for each series. That puts them on equal status.
> docs.python.org, besides being a namespace for specific version docs
> (/x.y, minus Nick's /latest) would be transitioned away from being a
> synonym for docs2. It could become a *neutral* index page listing docs2
> and docs3 for the 'latest' production version of each series and then
> each subdirectory.

I find docs2/3 ugly as it reminds me of load balancing (like
www1.python.org) and it also doesn’t really make sense to me. I have no
problem to have these DNS records and redirect them to docs.python.org/2
or /3 but I wouldn’t like them to be the canonical URIs.
_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


merwok at netwok

May 21, 2012, 10:58 AM

Post #41 of 43 (127 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

Le 21/05/2012 07:42, Georg Brandl a écrit :
> What about:
>
> * Canonical:
>
> docs.python.org/2/
> docs.python.org/3/
>
> for latest versions of 2.x and 3.x
>
> docs.python.org/2.7/ etc.
>
> for latest minor versions
>
> docs.python.org/dev/
>
> for latest dev version.
+1.

I’d be +1 to adding /stable but both 2.7 and 3.2 are stable at this time.

> * Redirected:
>
> docs.python.org/ --> either /2/ or /3/ or a "disambiguation page"
Either sounds good, I’m in favor of redirecting to /2 for a few years
still to preserve existing links and avoid the need to click on each page.

> docs.python.org/py3k/ -> /3/
+1, the py3k name is not obvious for everyone.

> There is also /release/X.Y.Z for individual released versions, which
> I don't want to change.
The URIs should not change, but it seems a bit bad to me that for
example the 2.7.1 docs don’t link to the latest 2.7 page and mention 2.6
as stable version

> I also like Martin's idea of offering more links between individual
> pages, not only the front-pages.
+1

On a related note, we may want to find a way to make the version more
prominent in the pages; I’ve seen beginners install Python 3 and use the
Python 2 docs and fail at the first print 'Hello, world!' example.
That’s why I support always having the version numbers in the URIs.

Cheers
_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


tjreedy at udel

May 21, 2012, 11:04 AM

Post #42 of 43 (133 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

On 5/21/2012 11:50 AM, Georg Brandl wrote:
> On 05/21/2012 02:14 PM, R. David Murray wrote:
>> On Mon, 21 May 2012 11:41:29 +0200, Georg Brandl<g.brandl [at] gmx> wrote:
>>> On 05/21/2012 03:23 AM, Guido van Rossum wrote:
>>>> I suggest that we add a separate (virtual) subdomain, e.g. docs3.python.org.

>>> Here are the time machine keys: this subdomain has existed for a few years now :)
>>
>> The fact that none of us knew about it may say something about its
>> effectiveness, though.
>
> Sure. I was never fond of it, but there was a discussion probably similar
> to this one, and it was agreed to add that subdomain.

Since there is no link to it from docs.python.org, of course it it
difficult to find 8-). Such a link is part of the otherwise redundant
proposal.

--
Terry Jan Reedy

_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com


stefan at sofa-rockers

May 22, 2012, 12:08 AM

Post #43 of 43 (128 views)
Permalink
Re: docs.python.org pointing to Python 3 by default? [In reply to]

Am 2012-05-21 um 19:58 schrieb Éric Araujo:

> Le 21/05/2012 07:42, Georg Brandl a écrit :
>> What about:
>>
>> * Canonical:
>>
>> docs.python.org/2/
>> docs.python.org/3/
>>
>> for latest versions of 2.x and 3.x
>>
>> docs.python.org/2.7/ etc.
>>
>> for latest minor versions
>>
>> docs.python.org/dev/
>>
>> for latest dev version.
> +1.
>
> I’d be +1 to adding /stable but both 2.7 and 3.2 are stable at this time.
>
>> * Redirected:
>>
>> docs.python.org/ --> either /2/ or /3/ or a "disambiguation page"
> Either sounds good, I’m in favor of redirecting to /2 for a few years
> still to preserve existing links and avoid the need to click on each page.
>
>> docs.python.org/py3k/ -> /3/
> +1, the py3k name is not obvious for everyone.
>
>> There is also /release/X.Y.Z for individual released versions, which
>> I don't want to change.
> The URIs should not change, but it seems a bit bad to me that for
> example the 2.7.1 docs don’t link to the latest 2.7 page and mention 2.6
> as stable version
>
>> I also like Martin's idea of offering more links between individual
>> pages, not only the front-pages.
> +1
>
> On a related note, we may want to find a way to make the version more
> prominent in the pages; I’ve seen beginners install Python 3 and use the
> Python 2 docs and fail at the first print 'Hello, world!' example.
> That’s why I support always having the version numbers in the URIs.
>
> Cheers

I think this URL scheme looks most clean:

docs.python.org/ --> Points to recommended version(2 for now, 3 later)
docs.python.org/2/ --> Points to latest stable 2.x
docs.python.org/2.7/
docs.python.org/2.6/
...
docs.python.org/3/ --> Points to latest stable 3.x
docs.python.org/3.2/
...
docs.python.org/dev/ --> Points to dev version (e.g., 3.3)

Using something like docs.python.org/stable/ in books might not make sense if the book is about Python 3 and /stable/ points to Python 4 a few years later.

Imho, adding additional sub-domains also wouldn’t improve anything, but would add more clutter and confusion (what if somebody types "docs3.python.org/2/ ?)

A prominent CCS-box showing the current version and offering Links to other main versions would make it perfect (e.g. 2, 3 and dev for all versions, 3.x sub-releases only, if you are under docs.python.org/3/... and for 2.x accordingly).

Cheers,
Stefan
_______________________________________________
Python-Dev mailing list
Python-Dev [at] python
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/list-python-dev%40lists.gossamer-threads.com

First page Previous page 1 2 Next page Last page  View All Python dev RSS feed   Index | Next | Previous | View Threaded
 
 


Interested in having your list archived? Contact Gossamer Threads
 
  Web Applications & Managed Hosting Powered by Gossamer Threads Inc.