T-Strings doc, PEP 750, and Amish barn raising

Documentation
, ,
1

(synthesis of several disparate conversations at Pycon US 2025 )

I mentioned to @dkp that @encukou and I are about to update the grammar chapter to include T-strings.
Dave said that he and @lys.nikolaou are working on docs for t-strings so I suggested that we could help. Dave seemed to appreciate the offer and said something about changes to libcst which I didn’t fully understand :blush: *

So, In the spirit of Amish bar building, 2025-06-04 livestream will include a discussion of how to help Peck et al get some t-string love into the cPython doc(s). I warned @brettcannon that we might shamelessly rip off get inspiration from his recent blog post, Unravelling t-strings .

  • BTW, #TIL the search feature in the libcst doc is powered by ReadTheDocs and it is sweet. Kudos to @ericholscher et al !!
2 Likes
2

Thanks Blaise!

By the way, we’ve got an official PEP 750 documentation TODO list here:

And we’ve got a broader “stuff we want to do before 3.14 ships” project here:

(I expect this will get much longer before it gets shorter.)

When do you do your livestreams? And can I crash your next one? :wink:

1 Like
3

PS: don’t think this was me. Maybe someone else mentioned it?

4

@dkp , I probably conflated libcst from another conversation. Thank you for noticing.

5

The events are streamed using the cPython docs Discord: Discord

and the recordings posted to YouTube:

@dkp , it would be very helpful if you could drop in next Wednesday. @koxudaxi is also welcome of course, but the timing might be difficult for Tokyo

Typically, we start at 10:00 ET, but on on some calendars it shows up at 11:00 ET. If the 11:00 start would make it easier for you to participate, I’ll confer with @encukou to see if we can start later.

1 Like
6

The Discord event time should be up to date; hopefully that’ll last until the next time zone change.

Lately we’re spending that time working on #127833, improving lexical analysis docs. We skipped string literals to avoid conflicts, but I’d love to go back to it, and put in t-strings as well.

I can’t move the slot; if you join later then we’ll spend an hour improving other string docs :‍)

1 Like
7

I won’t be able to make next week, but I remain keen to review/contribute to the t-string documentation.

A

2 Likes
8

Thank you for joining this initiative! You’re right, it would be quite late at night for me, so I think it will be difficult for me to participate. Please don’t worry about my schedule and proceed as planned.

1 Like
9

I’m learning about t-strings…

(and I bet I had conflated libcst with string.templatelib.Template)