bpo-47097: Add documentation for TypeVarTuple by mrahtz · Pull Request #32103 · python/cpython
Here's the first part of the documentation for PEP 646: documentation of TypeVarTuple in https://docs.python.org/3.11/library/typing.html.
I've kept this information self-contained in the section on TypeVarTuple rather than e.g. also writing about TypeVarTuple in the section on Generic because, let's face it, user-defined generics are kinda tricky, and if a user is reading about Generic for the first time, we don't want to overload them.
There are many other things from the PEP we could write about here, but I'm assuming that best practice is to keep the docs accessible by only including the key bits of info, and linking to the PEP itself for more details?
I'm also unsure about whether we should add something about Unpack here. On one hand, it's only relevant for older versions of Python, so I lean towards thinking we should only write about it when we get to backporting? On the other hand, it's still going to be a public member of typing.py, so maybe it would be better to say at least something?
Pedagogical feedback also appreciated :) I wouldn't be surprised if there's an easier way to explain this.