I am at a high-beginner/low-intermediate level in Python, and one thing that drives me nuts is how poorly I am able to read the Python official documentation and grok how to use the described code.

What’s the secret? Are there any guides/videos/books that can help my understand how to approach reading it? Or, is it just one of those things that I need to just keep coming back to while coding, and eventually I will get the hang of it?

  • ryokimball@infosec.pub
    link
    fedilink
    arrow-up
    10
    arrow-down
    1
    ·
    1 year ago

    Honestly I still often look up alternate documentation, searching “how do I do x?” instead of reading the actual documentation. I think the official documentation tends to be very technical about everything you need to know about the modules, etc. But if you’re trying to get one particular thing done in a hurry, finding something someone else has already done and copying it as much easier.

    That said, I do believe the official documentation gets better with age/the more you come back to it.

    • Bristlerock@kbin.social
      link
      fedilink
      arrow-up
      2
      ·
      1 year ago

      Agreed. The lack of varied examples in documentation is my common tripping point. When I hate myself, I use visit SarcasmStackOverflow to find examples, and then reference those against the module’s documentation.

      And it’s definitely become an easier process as I’ve read more documentation.

    • maor@lemmy.org.il
      link
      fedilink
      arrow-up
      1
      ·
      1 year ago

      Yep, it’s more of a reference. I like the argparse tutorial and would love to see more docs of this kind though