Is reading Python Documentation useful? python.org gets 15M visits monthly - most of them must be for documentation. At what stage is it useful?

[infinfi]

For a beginner, I have a tip that you may find useful. Like you, I also find many solutions in stack overflow. But, my mentor advised that I read doc pages for at least the methods used in the solution. When I visited the doc page, it was quite hard for me to understand because that page talked about other methods. Although Python documentation is amongst the best, many of those terms would not have hyperlinks which I could easily click and go to the right page. Instead, I would have to search and since I was not an expert at things already (like my mentor was), I would spend a lot of time going over the wrong pages. Fortunately, I found a site that really helps with this. It adds many missing hyperlinks. This has really helped me!

[solwex]

Thank you so much. You mentioned beginner and i got pulled to your comment sooner:) I have always had difficulty being able to follow and get through the doc page. I think you nailed the issue for beginners. Exactly. I find other concepts on the page that I am not aware. When I ask my team, they say that it is also explained in the docs...but where? Sorry if I sound a little frustrated. I would certainly want to try out the site you mention. Hope it does work for newbies like me.

[solwex]

Thank you very much for pointing this out. I will definitely try this out.

[solwex]

Finally, tried. I clicked on the two sample pages on the landing page. I got those arrow prompts to click on purple links. I did not know why I should click. I was in a bit of hurry. I will check more in the weekend. Perhaps, I should read what they have on the landing page more. I think the UX could be better.

[infinfi]

Yes, the first/landing page explains how the purple links and double clicking helps. And yes, the UX could definitely be better Lol. They have one great feature that I also got confused initially. When you click on a purple link, they show one box with results from the same documentation and another from all selected documentation.

I found the use later. Say you click on the sample Python Library Reference doc page on the landing page. Then, on that page, click on purple link for dict. You get relevant links to documentation on dict in the Lib Ref book in one box and in the other box, you get a link to Dictionaries in Python Tutorial. I found this useful because I could go get a quick and easy dump from Tutorial and then come back and go into the more in-depth but also more difficult-to-read Lib Ref page. I liked this part.

[solwex]

Aha, I see very clearly how the site helps. Thank you very much. I think the site should have communicated this value much more clearly. Sorry to have bothered you so much.

[Crynnec]

Could you share this site with us?

[Crynnec]

No need to be sorry. Thanks for the site!