2 ms·
Personally, it's because the docs aren't that good unless you're looking for something very specific. People are talking about the fact that there are no ads, b
by sheepybloke 3y ago
Personally, it's because the docs aren't that good unless you're looking for something very specific. People are talking about the fact that there are no ads, but I would think it's because of the bounce rate. I could see there being a lot of people learning Python who go to the docs, see a large chunk of text with OK examples, and then bouncing to go to the other sites that have more examples. This is something that's happened to me a lot when I was doing Python development. Some of the stuff is very helpful on the docs (e.g. asyncio), but for other things the actual stuff that I want to do gets lost in the details of the docs. So while ads probably play a part, I think the bounce rate is a bigger factor, especially for people who aren't necessarily developers.
- cloverich 3y agoI 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).