This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author mdk
Recipients Ido Michael, JulienPalard, LewisGaul, Mariatta, aeros, docs@python, eric.smith, fdrake, mdk, rhettinger
Date 2019-11-14.22:15:11
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1573769712.38.0.592398476731.issue38351@roundup.psfhosted.org>
In-reply-to
Content
So, for newcomers finding this via "easy issues", go for it, you can fix this one :)

On the different subjects discussed:

# Mass-edit the stdlib

We all agree that we should not mass-edit stdlib, (yet upgrading %-formatting to a newer syntax when modifying the same line may sometimes be a good idea).


# Mass-edit the doc

Having an f-string only doc is not possible, as Raymond mentionned (i18n, logging, templating), and not desirable: we need to document all existing formatting syntax. But the question is less "should we move everything to f-strings" than "should we move most examples out of %-formatting".


# Let's not encourage %-formatting

As we introduced str.format to fix issues from %-formatting [1] and allow extending formatting [2], we should not encourage newcomers to %-format strings.

Good news: in the tutorial there's a *single* occurence of %-formatting in a paragraph named "Old string formatting"!

There's probably a bunch of other places where upgrading the syntax in the doc would be a good idea, let's do it as we see them, when we feel it should obviously be upgraded, it also make nice easy issues, exactly as Mariatta did with this one (thanks Mariatta!).


[1]: %-formatting a single value that may or may not be a tuple.
[2]: allowing to format everything thrue __format__, not just the hardcoded list of type recognized by %-formatting.
History
Date User Action Args
2019-11-14 22:15:12mdksetrecipients: + mdk, fdrake, rhettinger, eric.smith, docs@python, JulienPalard, Mariatta, aeros, Ido Michael, LewisGaul
2019-11-14 22:15:12mdksetmessageid: <1573769712.38.0.592398476731.issue38351@roundup.psfhosted.org>
2019-11-14 22:15:12mdklinkissue38351 messages
2019-11-14 22:15:11mdkcreate