In this patch, I have updated the version of Python, from 3.4 to 3.5.
And added Ned Deily in the Release Manager for 3.6.

I don't think most of the version numbers are very important here and I wouldn't change them unless there is a valid reason.

> -3.4 and 3.5, first fix it in ``3.4`` and then merge ``3.4`` into ``default``
> -(which holds the future 3.5).
> +3.5 and 3.6, first fix it in ``3.5`` and then merge ``3.6`` into ``default``
> +(which holds the future 3.6).

This change looks wrong to me. In the original text, 3.4 and default are branch names. There won't be a branch named 3.6 until late 2016.

> -For versions 3.4 and before, this was conventionally done when the final
> -release was cut (for example, 3.4.0 final).
> +For versions 3.5 and before, this was conventionally done when the final
> +release was cut (for example, 3.5.0 final).

This also looks wrong to me.

I'm +1 to commit the following changes in devcycle.rst:

> -There are 5 open branches right now in the Mercurial repository:
> +There are 6 open branches right now in the Mercurial repository:
 
> -- the ``default`` branch holds the future 3.5 version and descends from ``3.4``
> -  (RM: Larry Hastings)
> +- the ``default`` branch holds the future 3.6 version and descends from ``3.5``
> +  (RM: Ned Deily)
> +- the ``3.5`` branch holds bug fixes for future 3.5.x maintenance releases
> +  and descends from ``3.4`` (RM: Larry Hastings)

It might also worth to update the build-dep command in setup.rst.

Hi Berker,

Thank you for your review,

> I don't think most of the version numbers are very important here and I wouldn't change them unless there is a valid reason.
My first opinion when I have read the documentation was "but this doc is
out of date".
It's my reason, for me, it's valid.

In fact, that was not for the pleasure to change some numbers, but to
reflect the reality.

> 
> > -3.4 and 3.5, first fix it in ``3.4`` and then merge ``3.4`` into ``default``
> > -(which holds the future 3.5).
> > +3.5 and 3.6, first fix it in ``3.5`` and then merge ``3.6`` into ``default``
> > +(which holds the future 3.6).
> 
> This change looks wrong to me. In the original text, 3.4 and default
> are branch names. There won't be a branch named 3.6 until late 2016.
What do you suggest in this case? 
> 
> > -For versions 3.4 and before, this was conventionally done when the final
> > -release was cut (for example, 3.4.0 final).
> > +For versions 3.5 and before, this was conventionally done when the final
> > +release was cut (for example, 3.5.0 final).
> 
> This also looks wrong to me.
Ok
> 
> I'm +1 to commit the following changes in devcycle.rst:
> 
> > -There are 5 open branches right now in the Mercurial repository:
> > +There are 6 open branches right now in the Mercurial repository:
>  
> > -- the ``default`` branch holds the future 3.5 version and descends from ``3.4``
> > -  (RM: Larry Hastings)
> > +- the ``default`` branch holds the future 3.6 version and descends from ``3.5``
> > +  (RM: Ned Deily)
> > +- the ``3.5`` branch holds bug fixes for future 3.5.x maintenance releases
> > +  and descends from ``3.4`` (RM: Larry Hastings)
> 
> It might also worth to update the build-dep command in setup.rst.
I agree, I am going to check that

What do you suggest for this patch? Update my patch with the right
paragraphes ?

Tell me,

Thank you

> My first opinion when I have read the documentation was "but this doc is out of date".

Yes, some parts of the devguide is outdated and I already gave +1 to update those parts. But most of the other changes are use 3.4 as an example so changing it to 3.5 won't make the devguide up-to-date. For example,

    +must not be broken at any point between sibling minor releases (3.5.1, etc.).
    +For both rules, only rare exceptions are accepted and **must** be discussed
    +first.

and

    -while the maintenance branch names (``2.7``, ``3.4``, etc) are mapped
    +while the maintenance branch names (``2.7``, ``3.5``, etc) are mapped

>> It might also worth to update the build-dep command in setup.rst.
> I agree, I am going to check that

You've already changed setup.rst :) But it would great if you could test "sudo apt-get build-dep python3.5" and build Python on a modern Debian/Ubuntu since I'm still on 12.04.

It's very hard to point which parts are OK in the patch without Rietveld. I'll update it myself and attach here to save both of us some time :)

Thanks!

The section of committing.rst in question was updated from 3.3 and 3.4 to 3.4 and 3.5 in 414a7e2067b2 after 3.4 came out.  I think we should continue to update it.

With rst is possible to define replacements once like:

  .. |current_branch| replace:: 3.6
  .. |prev_branch| replace:: 3.5

and use them across the devguide, however I'm afraid this won't work with code blocks.  Perhaps a new entry about updating the devguide can be added to PEP 101, and then the release manager can simply create an issue about it and let someone else take care of it (this kind of issues are good for beginners).

New changeset 32545ee8d673 by Berker Peksag in branch 'default':
Issue #25704: Update Python version to 3.5 where appropriate
https://hg.python.org/devguide/rev/32545ee8d673

Thanks, Stéphane! Ned applied most of your patch in f53eac8da0b8. I left "sudo apt-get build-dep python3.4" as is since python3.5 is not available in the latest LTS release of Ubuntu.