Over the past one and a half years, Stack Overflow has lost around 50% of its traffic. This decline is similarly reflected in site usage, with approximately a 50% decrease in the number of questions and answers, as well as the number of votes these posts receive.

The charts below show the usage represented by a moving average of 49 days.


What happened?

  • DeadlineX@lemm.ee
    link
    fedilink
    arrow-up
    35
    ·
    edit-2
    1 year ago

    I’d rather read the docs than just about anything. I love good documentation. I wanna know how and why things work.

    The problem is that basically nobody has good docs. They are almost all either incomplete or unreadable.

    • RoboRay@kbin.social
      link
      fedilink
      arrow-up
      19
      ·
      edit-2
      1 year ago

      A lot of companies won’t employ technical writers, who exist to make good, thorough, complete and well-presented documentation… they rather assume their engineers can just write the docs.

      And no, no they can’t… very few engineers study the principles of effective communication. They may understand things, but they can’t explain them.

      • DeadlineX@lemm.ee
        link
        fedilink
        arrow-up
        1
        ·
        1 year ago

        That’s fair. At my company we have technical writers for the external docs and internal docs are usually written by whoever has worked on something and got frustrated that nobody in the company could give them a high level overview, and they had to go through the code for a couple hours.

        Tbf though, I’ll take docs that aren’t written super well that tell me how things from our internal libraries should be used. Or just comments. I’ll take comments telling me WHY we are doing something.

        I don’t expect our internal docs to be MSDN docs. But I like to read an overview of at least the workflow before I jump into updating a large project.

    • doxxx@lemmy.ca
      link
      fedilink
      arrow-up
      15
      ·
      1 year ago

      While I agree, writing good docs is hard for a very intangible benefit. Honestly, it feels like doing the same work twice, with the prospect of doing it again and again in the future as the software is updated. It’s a little demoralizing.

      • DeadlineX@lemm.ee
        link
        fedilink
        arrow-up
        4
        ·
        1 year ago

        It is hard, I agree. I’m not very good at it myself. But even semi-decent docs are better than googling around or stepping through a decompiled package.

        And it’s super useful to new developers, and would have saved me a lot of time and frustration when I was new.