[docs] PEP 498 f-strings need to be documented (issue 25179)

eric at trueblade.com eric at trueblade.com
Sun Feb 7 10:32:18 EST 2016


Reviewers: ,

Message:
Thanks for taking this on!

I have just a few nits, as noted.


http://bugs.python.org/review/25179/diff/16513/Doc/reference/lexical_analysis.rst
File Doc/reference/lexical_analysis.rst (right):

http://bugs.python.org/review/25179/diff/16513/Doc/reference/lexical_analysis.rst#newcode661
Doc/reference/lexical_analysis.rst:661: cannot be split between
literals.
between -> across

http://bugs.python.org/review/25179/diff/16513/Doc/whatsnew/3.6.rst
File Doc/whatsnew/3.6.rst (right):

http://bugs.python.org/review/25179/diff/16513/Doc/whatsnew/3.6.rst#newcode95
Doc/whatsnew/3.6.rst:95: >>> f"He said his name is {name!r}."
Many people will see this as their first example. As such, I'd delete
the !r and just have it be f"He said his name is {name}."

I think !r would tend to scare people off.



Please review this at http://bugs.python.org/review/25179/

Affected files:
  Doc/faq/programming.rst
  Doc/library/datetime.rst
  Doc/library/enum.rst
  Doc/library/stdtypes.rst
  Doc/library/string.rst
  Doc/reference/datamodel.rst
  Doc/reference/lexical_analysis.rst
  Doc/tutorial/inputoutput.rst
  Doc/tutorial/introduction.rst
  Doc/whatsnew/3.6.rst




More information about the docs mailing list