Humans are much better at inferring rules from examples than at deducing an example from a concisely stated rule. The official python docs are the latter.