Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

gh-132661: Document t-strings andtemplatelib#135229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Draft
davepeck wants to merge26 commits intopython:main
base:main
Choose a base branch
Loading
fromt-strings:docs/pep750-first-pass

Conversation

davepeck
Copy link
Contributor

@davepeckdavepeck commentedJun 6, 2025•
edited by github-actionsbot
Loading

[DRAFT] This has onlyjust begun and is very much a work in progress; putting up a draft PR now for visibility.

We're keeping aTODO list of PEP 750 documentation tasks. There's lots to do.

📚 Documentation preview 📚:https://cpython-previews--135229.org.readthedocs.build/

@davepeck
Copy link
ContributorAuthor

@hugovk Thank you for the review and the helpful early feedback! Useful to know about linking.

(FWIW this isvery early stage still, so I expect plenty more linting and other issues that we'll eventually resolve.)

hugovk reacted with thumbs up emoji

@@ -1044,7 +1082,7 @@ readability::

Either of these parts, but not both, can be empty. For example::

10. # (equivalent to 10.0)
1. # (equivalent to 10.0)
Copy link
Member

@encukouencukouJun 27, 2025•
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

This is incorrect (and unrelated).

Suggested change
1. # (equivalent to 10.0)
10. # (equivalent to 10.0)

t-string
String literals prefixed with ``'t'`` or ``'T'`` are commonly called
"t-strings" which is short for
:ref:`template string literals <t-strings>`. See also :pep:`750`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

The PEP is the original change proposal, and it's expected to go go out of date. It's good to have a link to it in the docs (e.g. a “see also” in the main docs for the feature), so people can read the motivation and get at the discussion links, but if there's any other info in the PEP that's relevant to readers, it should go in the docs.

Suggested change
:ref:`template string literals<t-strings>`. See also:pep:`750`.
:ref:`template string literals<t-strings>`.

(And yes, the current docs aren't too great at this.)

Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment
Reviewers

@encukouencukouencukou left review comments

@hugovkhugovkhugovk left review comments

@lysnikolaoulysnikolaouAwaiting requested review from lysnikolaoulysnikolaou will be requested when the pull request is marked ready for reviewlysnikolaou is a code owner

@willingcwillingcAwaiting requested review from willingcwillingc will be requested when the pull request is marked ready for reviewwillingc is a code owner

@AA-TurnerAA-TurnerAwaiting requested review from AA-TurnerAA-Turner will be requested when the pull request is marked ready for reviewAA-Turner is a code owner

Assignees
No one assigned
Labels
docsDocumentation in the Doc dirskip news
Projects
Status: Todo
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

4 participants
@davepeck@encukou@hugovk@pauleveritt
[8]ページ先頭
©2009-2025 Movatter.jp