### Documentation The first three paragraphs of the [current defaultdict class docs](url) currently read: > Return a new dictionary-like object. defaultdict is a subclass of the built-in [dict](https://docs.python.org/3.16/library/stdtypes.html#dict) class. It overrides one method and adds one writable instance variable. The remaining functionality is the same as for the dict class and is not documented here. >The first argument provides the initial value for the [default_factory](https://docs.python.org/3.16/library/collections.html#collections.defaultdict.default_factory) attribute; it defaults to None. All remaining arguments are treated the same as if they were passed to the [dict](https://docs.python.org/3.16/library/stdtypes.html#dict) constructor, including keyword arguments. > defaultdicts are [generic](https://docs.python.org/3.16/library/typing.html#generics) over two types, signifying (respectively) the types of the dictionary’s keys and values. Nowhere in this do we learn about what the defaultdict does differently from dict. We don't even learn what the default_factory parameter is. In fact, the description of the `default_factory` attribute is decidedly uninformative as well: > This attribute is used by the [__missing__()](https://docs.python.org/3.16/library/collections.html#collections.defaultdict.__missing__) method; it is initialized from the first argument to the constructor, if present, or to None, if absent. Basically, I need to read the documentation of the dunder method `__missing__` to learn what imo should be stated somewhere at the top earlier. Suggestions: 1. Have a few beginner-friendly introductory sentences that explain in plain language what defaultdict is / how its behaviour differs from dict. For example, the first sentence of the `namedtuple` section is "Named tuples assign meaning to each position in a tuple and allow for more readable, self-documenting code." The utility / motivation for defaultdict is explained well in the Examples section so that doesn't need to be stated (and it feels hard to state its utility without examples). 2. Expand the `default_factory` attribute documentation so it is more standalone. At the very least it should state that it should be a callable? The fact that the `default_factory` parameter must be a callable (or None) should also be stated up top, since the code otherwise throws a TypeError. Some previous discussions: #131490, #85787 #53745 Happy to try a PR. :-)