I have now addressed Nick's comments and backported to Python 2.7.<br><br><div class="gmail_quote">On Sat Dec 06 2014 at 8:40:24 AM Brett Cannon <<a href="mailto:bcannon@gmail.com">bcannon@gmail.com</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Thanks for the feedback. I'll update the doc probably on Friday.<br><br><div class="gmail_quote">On Sat Dec 06 2014 at 12:41:54 AM Nick Coghlan <<a href="mailto:ncoghlan@gmail.com" target="_blank">ncoghlan@gmail.com</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 6 December 2014 at 14:40, Nick Coghlan <<a href="mailto:ncoghlan@gmail.com" target="_blank">ncoghlan@gmail.com</a>> wrote:<br>
> On 6 December 2014 at 10:44, Benjamin Peterson <<a href="mailto:benjamin@python.org" target="_blank">benjamin@python.org</a>> wrote:<br>
>> On Fri, Dec 5, 2014, at 18:16, Donald Stufft wrote:<br>
>>> Do we need to update it? Can it just redirect to the 3 version?<br>
>><br>
>> Technically, yes, of course. However, that would unexpected take you out<br>
>> of the Python 2 docs "context". Also, that doesn't solve the problem for<br>
>> the downloadable versions of the docs.<br>
><br>
> As Benjamin says, we'll likely want to update the Python 2 version<br>
> eventually for the benefit of the downloadable version of the docs,<br>
> but Brett's also right it makes sense to wait for feedback on the<br>
> Python 3 version and then backport the most up to date text wholesale.<br>
><br>
> In terms of the text itself, this is a great update Brett - thanks!<br>
><br>
> A couple of specific notes:<br>
><br>
> * <a href="http://python-future.org/compatible_idioms.html" target="_blank">http://python-future.org/<u></u>compa<u></u>tible_idioms.html</a> is my favourite<br>
> short list of "What are the specific Python 2 only habits that I need<br>
> to unlearn in order to start writing 2/3 compatible code?". It could<br>
> be worth mentioning in addition to the What's New documents and the<br>
> full Python 3 Porting book.<br>
><br>
> * it's potentially worth explicitly noting the "bytes(index_value)"<br>
> and "str(bytes_value)" traps when discussing the bytes/text changes.<br>
> Those do rather different things in Python 2 & 3, but won't emit an<br>
> error or warning in either version.<br>
<br>
Given that 3.4 and 2.7.9 will be the first exposure some users will<br>
have had to pip, would it perhaps be worth explicitly mentioning the<br>
"pip install <X>" commands for the various tools? At least pylint's<br>
PyPI page only gives the manual download instructions, including which<br>
dependencies you will need to install.<br>
<br>
Cheers,<br>
Nick.<br>
<br>
--<br>
Nick Coghlan   |   <a href="mailto:ncoghlan@gmail.com" target="_blank">ncoghlan@gmail.com</a>   |   Brisbane, Australia<br>
</blockquote></div></blockquote></div>