The doc for pprint.PrettyPrinter at https://docs.python.org/3/library/pprint.html says:

    If sort_dicts is true (the default), dictionaries will be formatted with their keys sorted, otherwise they will display in insertion order

I believe the insertion order is not even known by normal dicts (only by OrderedDict), so I think the last phrase must be wrong. If it's somehow correct, it deserves explaining....

dicts preserve their insertion order from Python 3.6 and is reflected in the documentation unless I am missing something here.

How about 'in their default insertion order'?

I don't think that any change is needed here. Adding "their default" to insertion order doesn't really help: if the reader knows dicts are now ordered, adding "default" is redundant; if the reader doesn't know, they'll still be confused. "What default insertion order? Dicts don't know their insertion order!" (Well actually they do.)

In a handful of more releases, most Python programmers won't even know, or will have forgotten, that there was ever a time that dicts didn't preserve insertion order, just as most of them don't know that there was ever a time that sorting wasn't stable or that dicts lacked an `update` method :-)

No offense to Steven here, but the problem wasn't with the docs (they are correct and accurate) but with his outdated knowledge of dicts. It's a perfectly understandable mistake to make, but it was a mistake.

I'm closing the task, but if anyone feels strongly enough to re-open it, I won't object.

Closing is fine with me.