• marcos@lemmy.world
      link
      fedilink
      arrow-up
      7
      arrow-down
      3
      ·
      1 year ago

      Yeah, the knowledge that 6 hours of debugging can save you from 10 long and extenuating minutes of reading the documentation. That one you can only get by fixing the problem.

      • acwern@sh.itjust.works
        link
        fedilink
        arrow-up
        6
        ·
        1 year ago

        Docs can only really help you if your problem is “I have used X from the library Y, yet I do not understand the baseline definition of X sufficiently and this is causing issues”. A lot of problems in practice are much more fundamental than that

  • Anonymousllama@lemmy.world
    link
    fedilink
    arrow-up
    16
    ·
    1 year ago

    Yeah but have you seen some people’s documentation? I get it’s not a glamorous task but I’ve seen some stinkers before (a heap of properties and methods just thrown on a page with barely any description and no reasonable samples)

    • lobut@lemmy.ca
      link
      fedilink
      arrow-up
      3
      ·
      1 year ago

      I copied and pasted some code from their own docs and it was missing required fields and those fields weren’t clear or documented well. Going into their code helped more but still.

      Also, the docs weren’t written with me in mind. It’s like if you were already familiar with it or a previous version because I swear I read it four times.

  • FederatedSaint@lemmy.world
    link
    fedilink
    arrow-up
    11
    ·
    1 year ago

    WAIT WAIT who made this??? It’s unreadable!!!

    He speaks while on Battle Cat, then departs on a Battle Ram? It’s unconscionable. So pedestrian.

    • newIdentity@sh.itjust.works
      link
      fedilink
      arrow-up
      4
      ·
      1 year ago

      It actually kinda is. GPT-4 has an enormous token size so you can upload the whole documentation of a framework or program and ask it specific questions to it

      • philm@programming.dev
        link
        fedilink
        arrow-up
        3
        ·
        1 year ago

        Has it though?

        AFAIK it has like 4k tokens which roughly translate to 3k words or something like that.

        The API has 8k or even 32k (this model should be interesting for something like that, unfortunately still don’t have access to it…)

        So the docs have to be rather short, that it gets all the relevant stuff, or am I missing something?

        • sheogorath@lemmy.world
          link
          fedilink
          arrow-up
          3
          ·
          1 year ago

          GitHub Copilot just got an update increasing the token to 8k so I think it can be queried to help you with something similar. I haven’t had the chance to test it further after the new update.