• anotherlemmyuser@lemmy.ml
    link
    fedilink
    arrow-up
    33
    ·
    1 year ago

    StackOverflow is good for:

    • general questions (when you don’t know where to look for) eg. how do I go about …?

    • specific questions (when you know what you want, in simple english) eg. suggest ways I can …?

    • quick fixes with more than one suggestion eg. I get this error, how to fix and please explain.

    • understanding concepts as different people explain concepts differently eg. what is …?

    Documentation is good for:

    • details (when you need to know more and when you really know what you need)

    • features (find a list when you want to know what else you can do with it)

    • PeterPoopshit@lemmy.ml
      link
      fedilink
      arrow-up
      9
      arrow-down
      1
      ·
      edit-2
      1 year ago

      Another thing stackoverflow is good for is if you’re like 14, don’t really know programming that well and can’t quite comprehend what you’re doing but know how to copy and paste code then fidget around with it until your ide stops complaining and it compiles and all works together.

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

      Stack Overflow refuses to provide answers for:

      • general questions (when you don’t know where to look for) eg. how do I go about …?
      • understanding concepts as different people explain concepts differently eg. what is …?

      Specific questions and quick fixes are the faster changing kind of knowledge you can have. And Stack Overflow consistently refuses to update old knowledge.

      So, in practice, it’s good for:

      But anyway, some ecosystems documentation are worse, so SO wins.

  • danc4498@lemmy.world
    link
    fedilink
    arrow-up
    31
    arrow-down
    1
    ·
    1 year ago

    I feel like memes like these are written by documentation writers. I usually fine what I need way faster in stack overflow than the documentation.

    • jeff 👨‍💻@programming.dev
      link
      fedilink
      arrow-up
      8
      arrow-down
      1
      ·
      1 year ago

      There’s really good documentation out there and there’s bad/nonexistent documentation. So stackoverflow is going to be a more consistent experience.

      Also I think it is a bit of a skill to be able to read documentation well, especially for Jr. Devs that might not have fully grasped OOP.

      • spauldo@lemmy.ml
        link
        fedilink
        arrow-up
        3
        ·
        1 year ago

        Totally agree on the skill part. The ability to read documentation and understand it is extremely important. Especially if you need to coordinate with nonprogrammers like engineers, or if you work in fields that SO doesn’t cover well like I do.

  • rf_@lemmy.world
    link
    fedilink
    arrow-up
    26
    arrow-down
    1
    ·
    1 year ago

    Documentation is more often than not quite bad. Very abstract, hard to understand, few examples if any. Good writing is a skill.

  • Nioxic@lemmy.world
    link
    fedilink
    arrow-up
    24
    ·
    edit-2
    1 year ago

    I’ve read some documention

    and it’s often so terribly written, like its written BY and TO someone who already knows everything about it, so its super vague and so basically useless.

    a good example on documentation, IMO, is mozillas javascript documentation. that’s great.

    i really dont like microsofts C# documentation though. and there’s probably worse ones out there.

    (I will add, english isn’t my primary language and the documentation is almost exclusively available in english)

    • JPAKx4@lemmy.sdf.org
      link
      fedilink
      arrow-up
      11
      ·
      edit-2
      1 year ago

      Docs - method returns string.

      Stack overflow - 10 years of history of the old and new solutions to the exact problem you have based entirely off the stack trace

  • lka1988@sh.itjust.works
    link
    fedilink
    arrow-up
    20
    ·
    edit-2
    1 year ago

    Looking at you, Docker compose files.

    Docs: “make a docker-compose.yaml, it’s so easy!”

    Me: “How?? Where?? What’s the syntax?? ANYTHING AT ALL?”

    Some corner of a dusty website only three people have visited in the last two years: “here’s the syntax you need to use for these specific use cases, and you can put it anywhere as long as it’s consistent”

    Jesus Fucking Christ is it really that difficult to be a little more specific with this kind of thing? This is why I didn’t start using Docker until very recently. Their docs absolutely suck balls for someone who isn’t already familiar with it.

  • r00ty@kbin.life
    link
    fedilink
    arrow-up
    20
    arrow-down
    1
    ·
    1 year ago

    To be fair, documentation is very often a much longer route to understanding your specific use case. At the same time, SO is responsible for far too much cargo cult programming and I fear ChatGPT will be the same for this.

    • Kryomaani@sopuli.xyz
      link
      fedilink
      English
      arrow-up
      11
      arrow-down
      1
      ·
      edit-2
      1 year ago

      And there are way too many projects where the documentation is nonexistent or bare to the point of being counterproductive to wade through. I’ve seen way too many open source projects that purport to have documentation but when you open it, it’s just doxygen run over the raw source files with barely any documenting comments in them. If I wanted to see only the names of the classes and functions I’d just pop the source in an IDE, the point of documentation is to point out everything that isn’t immediately obvious just looking at names and to give examples.

      “Self-documenting code” is the biggest lie we tell ourselves to get out of writing actual, necessary documentation.

  • nxfsi@lemmy.world
    link
    fedilink
    arrow-up
    13
    arrow-down
    2
    ·
    1 year ago
    $ sudo Pacman -S <package>
    $ man <package>
    

    Turns out the executable is a different name entirely

  • Jee@lemmy.fmhy.ml
    link
    fedilink
    arrow-up
    12
    arrow-down
    1
    ·
    1 year ago

    When it comes to things that I am not familiar at, going through documentation is quite tedious and feels like walking blind just feeling things. Having a small easy to understand explanation helps a lot even if I have to then further look it up on documentation.

    • xpinchx@lemmy.world
      link
      fedilink
      arrow-up
      5
      ·
      1 year ago

      I do things probably the stupidest way imaginable and find someone’s git project using a library I need to use and see how they used it.

      People that release libraries with demos and use cases are angels, in my eyes at least.

  • bankimu@lemm.ee
    link
    fedilink
    arrow-up
    11
    arrow-down
    1
    ·
    1 year ago

    Are you sure the distances are not swapped?

    I certainly wouldn’t think possibly badly written and indexed docs without crowd sourced helpfulness indicator where you may or may not find your answer is 1/4 miles, while a concise highly upvoted answer in stack overflow is 21 miles.

  • crucifix_peen@lemmy.ml
    link
    fedilink
    arrow-up
    9
    ·
    1 year ago

    working on a project in python now

    first ~30 lines are just comment lines with hyperlinks to all the places I’ve stolen uhhh I mean, sourced, code from. And a solid 40% of them are stackoverflow

    • lackthought@lemmy.sdf.org
      link
      fedilink
      arrow-up
      2
      ·
      1 year ago

      I use chatgpt to get me pointed in the right direction and have it provide some basic boilerplate code for smaller tasks

      I needed to go through a bunch of .json files and modify various elements

      I was able to implement what I needed without google/documentation/stackoverflow

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

    I’ve been using chatgpt lately, super helpful. Basically Google on steroids