Originally opened in https://bugs.python.org/issue46066. Related discussion: https://github.com/python/mypy/issues/2492 According to the [documentation](https://docs.python.org/3/library/typing.html?#typing.TypedDict), there are two additional equivalent syntax for TypedDict definition: ```python 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, [PEP589](https://www.python.org/dev/peps/pep-0589/#id19) doesn't have this syntax. I think we could just deprecated it and remove it from the doc.