• Sibbo@sopuli.xyz
    link
    fedilink
    arrow-up
    9
    arrow-down
    58
    ·
    1 year ago

    This is often done by people while the project is unstable. No need to write documentation that gets outdated every few weeks, when you can help people live in discord.

    • unexposedhazard@discuss.tchncs.de
      link
      fedilink
      arrow-up
      68
      arrow-down
      1
      ·
      1 year ago

      thats understandable but at least use something searchable that has tagging capabilities and is archivable so that you can come back to it years later

      • renzev@lemmy.worldOP
        link
        fedilink
        English
        arrow-up
        23
        arrow-down
        7
        ·
        1 year ago

        D*scord is technically searchable and fairly archiveable (messages never get deleted due to old age (in my experience at least) or if the original poster deletes their account). And some d*scord servers even have a Q&A mode similar to st*ck *verflow. But yeah, not the right tool for the job, not to mention ABSOLUTELY PROPRIETARY

      • ѕєχυαℓ ρσℓутσρє@lemmy.sdf.org
        link
        fedilink
        arrow-up
        2
        arrow-down
        2
        ·
        1 year ago

        Zulip is a little better in this regard. I’m involved in Lean, which uses Zulip as the primary mode of support and documentation. While it’s usable, I still think that a Discourse style forum is the way to go.

    • Dave.@aussie.zone
      link
      fedilink
      arrow-up
      61
      ·
      edit-2
      1 year ago

      when you can help people live in discord.

      That live support is super handy when you’re 8 timezones apart from the maintainers.

      • Hey there, how do I get this thing to compile?

      11 hours later

      • Ok just need to make sure you have this list of prerequisites installed and then we can walk you through the compilation process.

      6 hours later

      • Nevermind, I built and installed another project.
      • T156@lemmy.world
        link
        fedilink
        English
        arrow-up
        2
        ·
        1 year ago

        Or if you find the project a while later, and the link/server is dead, either because the maintainer forgot to update the link, or the server shut down/removed invites for some reason, like spam prevention.

    • wizardbeard@lemmy.dbzer0.com
      link
      fedilink
      English
      arrow-up
      33
      ·
      1 year ago

      There needs to be some plan to migrate to stable documentation at some point though.

      Hell, even a small traditional forum is better searchable.

      What I see happen is that the people with the knowledge get so busy answering questions in discord that it impacts the efforts on documentation and on the software itself.