Should we just say that value, conversion and format_spec have the same meaning as in FormattedValue?

Semantically I'd prefer to keep them apart, I could see a future extension to t-strings that relaxes the conversion flag restriction for example. If consensus is to de-duplicate, though, no strong objections.

I think that even then, it might be good to point out only the ones that are actually different.

@JessicaTegner: hello! This is Petr, we met at EuroPython.

Here is a “diagram” that aims to explain how t-string Template's strings and values are related, but I'm afraid it's only usable for sighted people. Any suggestions for improving this would be welcome.
The diagram is already included in Python 3.14 docs; you can read the rendered version here: https://docs.python.org/3.14/library/string.templatelib.html

I had this problem when describing iter(Template) too -- how best to describe the "proper ordering" of template parts. We could do a worked example with displaying the list/tuple output perhaps?

hi @encukou it was nice meeting you.

After taking a look at the documentation, it's a bit angular where the diagram is supposed to be. I'm unsure if that's because I don't know what to look out for, it actually isn't on that page, or the screen reader skips it completely. Could you be more specific on where on the page it should be, so I can confirm what's going on.

This part, in the third code-block: https://docs.python.org/3.14/library/string.templatelib.html#string.templatelib.Template

I see now.
Looks good to me, all though, if you aren't careful, you could miss the "!" item.
Maybe it would be better with a table representation, but idk.

Thanks for checking!

If it looks good, let's keep it. A table might be too busy, and look too out of place among the other code blocks.

Yeah that makes sense.
I'm personally fine with this example, but if we maybe wanted to make it easier for people new to python using a screen reader, the example could be reworded to use something other than the "!" symbol, which would make it more obvious to screen reader, that there's 2 strings in the "template.strings".
Kind of a NIT here - just throwing ideas out there - but I'm personally okay with this.

I'd keep the original; the prefix is not in quotes.

The intent here was to convey it's the literal character, hence the quotation marks. Especially on smaller screens (or reader mode, etc) the distinction between roman and typewriter text can be harder to see.

I see. Should we keep the quotes outside the literal text then -- use '``r``'?

Also: this conflicts with my work-in-progress PR; let's do it there?

I'd prefer leaving the comma out. It's better grammar, but makes the strings tuple harder to read.

This was also partially in reference to that the proper phrase is "Hello, World[!]". The example is a little repetitive, I'll perhaps reintroduce the cheese-based ones from the PEP.

That's just Wikipedia choosing the most correct-looking variation for the article :)