• @clearleaf@lemmy.world
    cake
    link
    fedilink
    101
    edit-2
    9 months ago

    I don’t understand how devs can be too lazy to write documentation but somehow they’d rather explain the same shit in discord over and over and over and over and over and over

    • @RoyaltyInTraining@lemmy.world
      link
      fedilink
      509 months ago

      The help command is one of the first things I work on in any project. Even if I’m never gonna share it, my future self will appreciate it.

      • @kurwa@lemmy.world
        link
        fedilink
        99 months ago

        Even on simple scripts, it’s so help to remind yourself however the hell you made it work.

      • oce 🐆
        link
        fedilink
        59 months ago

        I always document a lot because I forget what I was doing one week after.

    • @Rooty@lemmy.world
      link
      fedilink
      41
      edit-2
      9 months ago

      Why is discord so popular in non-gaming circles? People use it as a shitty, bloated and centralized IRC clone, with the voice fuction being completely ignored.

      • Dym Sohin
        link
        fedilink
        99 months ago

        bc everyone is a gamer, and using another chatting app is just adding more clutter

      • @oldfart@lemm.ee
        link
        fedilink
        19 months ago

        I’m no discord fan but my recent attempts with using IRC failed because I had incorrect reverse dns or some shit like that. Obviously I have no control over that in a consumer connection.

        There are still better alternatives than Discord, though :)

    • peopleproblems
      link
      fedilink
      99 months ago

      I think it’s loneliness, honestly.

      That and corporate work environment tends to rewards those that can explain stuff vocally ad nauseum.

    • @hperrin@lemmy.world
      link
      fedilink
      79 months ago

      As someone who writes fairly extensive documentation, I can assure you that it doesn’t matter. People will still ask questions in your Discord that are answered in your documentation.

      I’ve learned that you kind of have to strike a balance between being terse enough that people will read it and verbose enough that it’s actually helpful, but there is a minimum number of questions you will always get.

    • @Treczoks@lemmy.world
      link
      fedilink
      39 months ago

      At work, I am one of the few who actually documents. Not only with Doxygen, but I also write real documents regarding all kinds of topics.

      Guess what? “I know you have this documented somewhere, but could you just quickly explain again how this common task works?”