I often skip python docs for this reason: I find myself scrolling to find actual usage examples of the functions I am looking up, preferably 3 short examples sh

I often skip python docs for this reason: I find myself scrolling to find actual usage examples of the functions I am looking up, preferably 3 short examples showing typical use cases + idiomatic code. Bonus points if it also references frequent mistakes, i.e. "for X use case you probably want Y instead." I am often surprised to find no usage examples at all, particularly for such a popular language (ex: itertools section). I'm not sure if this is consistent w/ a newer programmers mindset, but I often find looking at _just_ a few snippets is sufficient to understand the function's intended use case and capabilities, and can dive into details later if needed (ex: What's performace / memory usage like? How can I extend / combine this? etc).