typing_extensions icon indicating copy to clipboard operation
typing_extensions copied to clipboard

List of included items by the version in which they were included in Python.

Open nuno-andre opened this issue 2 years ago • 4 comments

This list, formerly included in the readme, is extremely useful. Especially when developing on a later version than the minimum supported by the code.

Would you consider adding it back into the docs?

nuno-andre avatar Nov 15 '23 10:11 nuno-andre

Yes, we can add a section for this in https://typing-extensions.readthedocs.io/en/latest/

JelleZijlstra avatar Nov 15 '23 13:11 JelleZijlstra

Happy to help with this. Could you provide a suitable format?

nuno-andre avatar Nov 16 '23 05:11 nuno-andre

Open to suggestions from others, but one approach would be to have a table with four columns:

  • Name of the object (cross-linked to its docs entry)
  • Python version when it was added to the standard library
  • Version when it was added to typing-extensions (if it's in the changelog, no need to figure out the exact versions before 4.0 when we didn't keep a changelog)
  • PEP that added the feature (if any)

JelleZijlstra avatar Nov 16 '23 05:11 JelleZijlstra

one approach would be to have a table with four columns

That sounds good to me. I'd vote for us using a list-table; they're much easier to maintain than the other style.

AlexWaygood avatar Nov 16 '23 06:11 AlexWaygood