• OneCardboardBox@lemmy.sdf.org
    link
    fedilink
    English
    arrow-up
    188
    arrow-down
    1
    ·
    10 months ago

    Firstly, discord is entirely the wrong medium for documentation.

    Secondly, documentation should be at least as accessible as the code. That is to say, if I can view the code without creating an account for some service, then I should also be able to read the documentation too.

    • dustyData@lemmy.world
      link
      fedilink
      arrow-up
      44
      ·
      10 months ago

      Documentation is bad enough. But it’s worse when that’s the only channel to get support. I once read a project maintainer boast that they never read the bug reports and issues on github and if anyone had a bug to just chat him up discord. I mean, dude, no wonder nobody uses your software or takes it seriously. Much less want to collaborate on the development.

      • shadow@lemmy.sdf.org
        link
        fedilink
        arrow-up
        11
        ·
        10 months ago

        I can’t understand why someone would want to do that. Maybe it’s my help desk and IT upbringing, but for the few software tools and things I’ve made, if you chat me without filing a bug/issue on GitHub, I’m not gonna help you.

    • Serinus@lemmy.world
      link
      fedilink
      arrow-up
      11
      ·
      10 months ago

      Agreed. I may not want to mix my discord identity with whatever project I’m looking at. I especially don’t want to mix my personal online identity with my professional identity. I post too much politics for that.