Deprecate keyword args syntax for TypedDict definition

[97littleleaf11]

BPO	46066
Nosy	@gvanrossum, @JelleZijlstra, @tirkarthi, @sobolevn, @Fidget-Spinner, @AlexWaygood, @97littleleaf11
PRs	bpo-46066: Deprecate kwargs syntax for TypedDict definitions #31126 bpo-46066: catch DeprecationWarning #31428

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2022-02-17.03:26:40.796>
created_at = <Date 2021-12-13.15:36:57.408>
labels = ['type-bug', 'library', '3.11']
title = 'Deprecate keyword args syntax for TypedDict definition'
updated_at = <Date 2022-02-20.01:44:58.632>
user = 'https://github.com/97littleleaf11'

bugs.python.org fields:

activity = <Date 2022-02-20.01:44:58.632>
actor = 'JelleZijlstra'
assignee = 'none'
closed = True
closed_date = <Date 2022-02-17.03:26:40.796>
closer = 'JelleZijlstra'
components = ['Library (Lib)']
creation = <Date 2021-12-13.15:36:57.408>
creator = '97littleleaf11'
dependencies = []
files = []
hgrepos = []
issue_num = 46066
keywords = ['patch']
message_count = 11.0
messages = ['408458', '408476', '408547', '412990', '413013', '413014', '413016', '413379', '413531', '413535', '413562']
nosy_count = 7.0
nosy_names = ['gvanrossum', 'JelleZijlstra', 'xtreak', 'sobolevn', 'kj', 'AlexWaygood', '97littleleaf11']
pr_nums = ['31126', '31428']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'behavior'
url = 'https://bugs.python.org/issue46066'
versions = ['Python 3.11']

[97littleleaf11]

According to the docs: https://docs.python.org/3/library/typing.html?#typing.TypedDict, there are two additional equivalent syntax for TypedDict definition.

Point2D = TypedDict('Point2D', x=int, y=int, label=str)
Point2D = TypedDict('Point2D', {'x': int, 'y': int, 'label': str})

However, the former one is quite confusing since we have the total keyword arg for TypedDict. In addition, PEP-589(https://www.python.org/dev/peps/pep-0589/#id19) doesn't have this.

I think we could discard the definition syntax using keyword args in the doc.

[gvanrossum]

This is not really just a doc issue then, is it? Maybe we should just deprecate the feature?