• @Zeon
      link
      82
      edit-2
      4 months ago

      There is FOSS alternatives out there like Revolt or just plain old IRC which is good enough imo. The Discord bullshit is so annoying.

      • @[email protected]
        link
        fedilink
        1514 months ago

        All chat programs are shit for long term accumulation of knowledge. Discord, revolt, IRC, they’re all just as bad for it.

        Forums are where you’ll find people who are actual experts discussing because they want to be able to easily reference previous posts by other people.

        • @Serinus
          link
          104 months ago

          IRC at least you have text logs, but I agree.

          • @[email protected]
            link
            fedilink
            3
            edit-2
            4 months ago

            Lemmy/Reddit style platforms are good at generating short term discussions, it’s threaded chats.

            The main features that makes forums the best to accumulate knowledge is bumping and linear discussions. There’s only one discussion that everyone is following if they want to talk about a specific subject, the knowledge on that subject is centralized and keeps accumulating instead of requiring to be constantly repeated because the previous thread is lost to time. The linear discussion means you don’t have to go back up and start reading a different branch to know what some other people are talking about (which often times leads to having many people basically saying the same thing without realizing it), all new replies appear in chronological order and people quote others to provide context when necessary.

            Look on old school forums for more “boomer hobbies” and it’s ridiculous how long conversations can keep going. I provided a link in another reply but the Yamaha WR250 thread on ADVRider has 428k replies since 2013, all that is possible to know about this motorcycle is in they thread and pretty much any question you might have will have its reply in there. There’s car forums with discussions that have been ongoing for decadeS!

            Meanwhile on Reddit of you want to ask a question in a thread that was started 24h ago you’re shit out of luck, no one but the OP will know about it. On Lemmy? Everyone sorts by top 6 hours.

            • @[email protected]
              link
              fedilink
              24 months ago

              In regards to the advrider comment, I don’t find those ridiculously long-running threads all that convenient even though they are very useful. In your example the WR250R thread could have multiple subtopics being discussed at once in the same thread which I find frustrating.

              For example, one guy might ask about tires and while that’s being discussed another guy shows up asking about a big bore kit to make more power. Now there are two discussions happening at the same time and all I can do is view the thread chronologically. Then someone else shows up asking what oil everyone uses. Then someone new joins and says “Hey it’s not possible to go back and read through all 2300 pages in this thread, what GPS are you all using?”

              Like sure it’s great that all the information is in that one thread but navigating through it only in chronological order can be super frustrating.

              • @[email protected]
                link
                fedilink
                14 months ago

                ADVRider is more of a “motorcycles in general” community and they try to limit the number of “subcommunities” (the Wr250 thread is in the Thumpers subcommunity), but a WR250 specific forum would have the discussions you’re talking about split up.

                The real solution though would be for a “Reddit style forum” to exist, where people can create new subcommunities however they want but to have it work like a forum instead of having threaded discussions that don’t get bumped.

                • @[email protected]
                  link
                  fedilink
                  1
                  edit-2
                  4 months ago

                  It actually drives me a little nuts that the 500 EXC-F thread is under Thumpers and not under Orange Crush. I get that it’s a Thumper, but it’s also a KTM. Why have a subcommunity based on engine type when all of the other engine types are in manufacturer-specific subcommunities?

      • Jo Miran
        link
        fedilink
        614 months ago

        I have been playing with the idea of a documentation.org. Something publicly funded (mostly through corporate and individual donations) that hosts technical manuals, white papers, guides, links to video tutorials (likely YouTube), FAQs, and even links to Discord and/or forums if they exist. Documents are public, free to index (no login to view), version controlled and held in perpetuity.

        Obviously there is much more to it, but I think we have reached a point where something like it is required.

          • Jo Miran
            link
            fedilink
            134 months ago

            In the most technical terms, yes. The idea is not new or bizarre, but I see the same missteps repeated. For starters, the venture HAS to be a nonprofit with zero need for monetization. It will also need an inviting and easy to navigate user interface, accessible to the most nontechnical of users. You need to have a massive document library from multiple large players from day one, so you need to have a lot of contacts.

            As I said it’s not fully cooked, but I have spoken to a few people that could help me make it happen and they seemed open to it.

        • @[email protected]
          link
          fedilink
          5
          edit-2
          4 months ago

          Please consider a Patreon for doc review. I don’t mean reviewing the doc against the project for fitness, as that’s the job of each project to maintain and review their own docs; I mean by a technical writer who can de-localize (you only think I mean ‘internationalize’) the document and make it syntactically and logically correct against a generic, classic style guide.

          The rising popularity of really bad errors is definitely turning me off from videos or documentation from a few sources with a lot of churn. It ruins the flow and it robs the assumption of authority which I’d argue is an important part of any documentation.

          • Jo Miran
            link
            fedilink
            24 months ago

            That is a good idea. I am fairly certain I could get funding and/or loaned resource time for English, Spanish, French and German, but crowd funding incentivized localization for other regions is brilliant.

        • @Serinus
          link
          34 months ago

          Also I’d rather just have these things in the repository.

      • @Treczoks
        link
        364 months ago

        That’s not the point. The point is that pointing to Discord means that there simply is no documentation.

        • @Zeon
          link
          3
          edit-2
          4 months ago

          I meant it more as a communication platform, not nescessarily for hosting documentation. Either way, using a forum is still pretty good alternative

      • @Siethron
        link
        44 months ago

        I only want the documentation if you have to fax it to me

      • @hushable
        link
        20
        edit-2
        4 months ago

        one time, I asked and got a reply that it has been answered already, followed by a rant of why the hell people were asking the same question over and over again. IDK man, maybe you could update the installation instructions in your readme, then people wouldn’t be flodding discord with the same question over and over again.

        (it was regarding the project being incompatible with the newest version of a library and you had to manually install an older version to get it to work)

  • @[email protected]
    link
    fedilink
    English
    2394 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
      link
      534 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.

      • @[email protected]
        link
        fedilink
        174 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.

        • @[email protected]
          link
          fedilink
          English
          64 months ago

          To play devil’s advocate here: sometimes there are genuine reasons to try and request support before making an issue. I’m not particularly smart, nor too techy. If something isn’t working, I’m just going to assume I’m an idiot and I’ve messed something up. If I can’t figure out how to make it work, my first post of call will be trying to find a community related to whatever isn’t working, or on smaller projects I might try and reach out to the Dev. Opening an issue always feels like a “hey, your program isn’t doing what it’s meant to do, here’s what’s wrong with it, please fix it” and not “I think I’ve fucked something up, can you please help?”

          I suppose it depends what you’re developing though.

            • @[email protected]
              link
              fedilink
              94 months ago

              Yep, and if it becomes a frequent request, add clarification to the readme / wiki / documentation.

              Also, if you push folks towards issues, then they become indexable by search engines! So even if you have a solved problem you can at least find that… Discord? It’s a black hole.

            • JustEnoughDucks
              link
              fedilink
              44 months ago

              And then get it insta-closed withing 20 minutes saying that “this is a problem with your setup, not the software” even when “my setup” was literally setting up their project using their documentation (docker compose files).

              That is how developers treat people with questions that they deem “stupid.”

              It turns out their documentation was wrong and some environment variable that they said was optional, was not actually optional and the service would go into a reboot loop without it. I figured that out no thanks to the devs.

              • @[email protected]
                link
                fedilink
                0
                edit-2
                4 months ago

                Update your issue with a pull request fixing the documentation. When you’re doing things on github, 99.999% of your audience is the general public, not the maintainer, because they will find your issue and solution through search engines.

    • @Serinus
      link
      144 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.

  • @DirkMcCallahan
    link
    1644 months ago

    Yes, this exactly! I still cannot fathom how Discord took off. It offers literally no advantages over forums, and introduces some massive disadvantages.

    • @voxelastronaut
      link
      1054 months ago

      It took off because it was objectively the best catch-all communication option for gamers at the time. It’s still the best option for certain use cases like that, but I’ll never understand why people prefer it for projects, troubleshooting, updates, etc. It seems incredibly lazy and unserious to me. And the current Discord mobile layout is absolutely horrible, making for a totally miserable user experience.

      • @[email protected]
        link
        fedilink
        20
        edit-2
        4 months ago

        I hated back in 2015 when people were leaving other communication platforms for the lesser option of Discord

        Even today Discord still doesn’t have directional chat and you can’t be in multiple calls at once

        At least mods help mask all the other missing features

        • @[email protected]
          link
          fedilink
          294 months ago

          I left mumble, teamspeak, and Skype for Discord.

          Discord is easily the better options among those choices.

          I also can’t think of much use for being in more than one call at once. I dunno seems like you’re just looking for a different thing. And that’s okay.

        • @Alexstarfire
          link
          154 months ago

          Discord didn’t, and still doesn’t, require a download. Easier for people to pick up and easier to use on locked down computers.

          • @[email protected]
            link
            fedilink
            24 months ago

            This. Whatever can be used on devices without admin rights, such as work or school devices, for “free”, will get picked up by normie worker drones and college students and minors in droves.

            It’s been pretty handy in a lot of ways, but yeah I do hate what it’s doing to indexable information and it’s only a matter of time before it goes for IPO and suddenly gets way worse seemingly overnight…

        • @Warl0k3
          link
          44 months ago

          I’m unfamiliar with Directional Chat outside of things like VRchat, how that work if you’re not manipulating your position in space relative to other users?

      • @[email protected]
        link
        fedilink
        3
        edit-2
        4 months ago

        My office has official chat (teams) and unofficial chat (Mattermost).

        I don’t think there’s anything wrong with having a more casual discussion platform at work, which is what Mattermost had become.

    • @[email protected]
      link
      fedilink
      64
      edit-2
      4 months ago

      At the beginning it originally had an appeal that anyone could create a voice chat server for free in a matter of seconds.

      Teamspeak needed a hosted dedicated server. Skype was “calls” and not communities. Mumble was hardly known.

      I completely accept why it took off but I hate where it has gone. it’s over complicated and feature creeped electron shite

    • @[email protected]
      link
      fedilink
      564 months ago

      tbf discord is good for organizing activities in games with online multiplayer. definitely shouldn’t be used for documentation in place of forums though.

      • @Alexstarfire
        link
        124 months ago

        Yea, I don’t get the documentation stuff. It’s like saying you’ll use Google Chat history as your documentation.

      • @someacnt_
        link
        64 months ago

        Also good for casual socializing

      • @yamanii
        link
        34 months ago

        I’m glad doujinstyle realized their mistakes and revived the website after some time as discord only.

    • JackbyDev
      link
      fedilink
      English
      204 months ago

      You can create a discord server instantly with a handful of clicks for free. That’s why.

      Also, plenty of people use it for chat.

      • @[email protected]
        link
        fedilink
        11
        edit-2
        4 months ago

        Modern web IRC clients like The Lounge or Convos can now display images, play mp3 and mp4 formats, and they have upload options. It can still be excellent for real time support, but I’m not so sure about documentation though.

        • @kittenzrulz123
          link
          8
          edit-2
          4 months ago

          Of course an IRC chat won’t be used for documentation, I meant for general chatting and support. Also I didn’t know that, hopefully I’ll be able to replace the absolutely proprietary discord with it.

    • @Trincapinones
      link
      94 months ago

      Because it was easier to create a server in discord than ts3

    • Chewy
      link
      fedilink
      74 months ago

      Discord is better than IRC in any way except available clients, while also doing voice/video chat rooms so it replaced Teamspeak/Mumble. With the additional (at first) paid streamers and being free it took off especially with younger audiences. I remember how terrible Skype was and Discord just worked.

    • @CliveRosfield
      link
      English
      -14 months ago

      You don’t see its incredible simplicity as an advantage? That’s crazy

        • @[email protected]
          link
          fedilink
          214 months ago

          Seriously. My only interactions with discord are in ways that its replaced a simple web forum or IRC channel.

          • @[email protected]
            link
            fedilink
            74 months ago

            Well if that’s your only exposure to it, then yeah I could see why you think it’s not good.

            But if you just want to hang out with a regular group of friends async and in voice chat, it’s pretty damn good.

        • TheHarpyEagle
          link
          1
          edit-2
          4 months ago

          Joining via server invites that guide you through sign up, no dedicated server to host (I know, major downside for people who don’t want all their stuff centralized to Discord’s servers), GUI server admin tools, etc.

          I think devs tend to vastly overestimate how tech-savvy the average person is. Bring up hosting, DNS, port forwarding, terminal, etc. and they’re going to nope out pretty quick. Provide an option that lets you do everything from a single GUI and they’ll use it. Enough people use it and eventually the tech-savvy folks have to follow because that’s where everyone is.

          That’s absolutely not to say that it’s a good medium for documentation. I will always prefer well-written and organized docs first and searchable forums/issue trackers/SO second. But that second group has a lot of tech elitism and devs who are (perhaps justifiably) short on patience, so Discord seems a lot more accessible to newbies who are asking the most basic questions.

      • @[email protected]
        link
        fedilink
        37
        edit-2
        4 months ago

        Notepad is simple

        Doesn’t mean it’s the best thing for documentation.

        Actually… a readme file is probably better for documentation if you’re really going for simple.

      • @De_Narm
        link
        314 months ago

        I may be getting old, but I think D*scord (I’m all for cencoring it like a slur) isn’t any more simple than a phpBB or something similar was. Quite the opposite actually, at least for any user trying to navigate the the darn thing.

        • @CliveRosfield
          link
          English
          1
          edit-2
          4 months ago

          Having used both, if you can somehow navigate a phbb board then you can easily navigate discord. The only thing stopping you is you.

          • @De_Narm
            link
            14 months ago

            Maybe navigating is the wrong term. It’s just impossible to find stuff relevant to me on discord. On any given larger server, there may be a few channels I could be interested in - but they are just a single chat log, often with lots of off-topic spam, and many different people having almost separate discussions at the same time. On any given larger phpBB, stuff is mostly separated into different threads with all the off-topic posts being delegated to a single thread. It’s better searchable and better organized.

            • @CliveRosfield
              link
              English
              24 months ago

              What even is “relevancy”? Their search is just a search by matching keywords. There isn’t a magic algorithm discord uses. Every time I had an issue with some sort of bug or function I just search for specific keywords and 9/10 times I find something. On the odd-chance I don’t then I’ll behave like a human being and ask. I just don’t get what’s wrong with that? You can already limit those keyword searches with specific constraints so you don’t get much noise.

        • @Wodge
          link
          English
          -94 months ago

          Counter-counterpoint: He did eat something off his foot in front of an audience.

      • @ikidd
        link
        English
        104 months ago

        Using Discord to support code is like trying to teach sculpture over the telephone.

      • experbia
        link
        84 months ago

        you don’t see a tool being too simple for the problem at hand to be a problem in tool selection? that’s also crazy.

      • @Caesium
        link
        64 months ago

        simplicity is a double edged sword. convinence is nice, but the internet feels a lot more homogenous these days than in the past

        • @CliveRosfield
          link
          English
          24 months ago

          Of all the counterpoints you can give me against discord not being simple, you choose file size. Lmao. I’m not even gonna start

  • @[email protected]
    link
    fedilink
    English
    1624 months ago

    What makes it even more crazy is 90% of projects are using github/gitlab/gitea or some other modern git platform that literally has a wiki feature built in. And everyone and their dog either knows or could very quickly learn how to use markdown to write the wiki.

    If you want a chatroom at least use matrix as it’s open source and privacy respecting. Though IRC is better for a community. And good old forums are best.

    • @[email protected]
      link
      fedilink
      244 months ago

      Matrix

      Open Element iOS

      Start stopwatch

      Syncing completes

      Stop stopwatch

      I have eight rooms added to the Matrix client! And Lemmings tell me it’s not Element, things are just slow.

      Hoping they were wrong and I’m doing something wrong or this is totally atypical (e.g. connected to a really slow server).

      FOSS is worth tradeoffs. Unindexable corporate software is regressive. But! Need some more speed over here! Individual chats/rooms are slow/buggy too.

      • @[email protected]
        link
        fedilink
        English
        44 months ago

        That’s the “historic matrix / element”

        Use newer ones with sliding sync capabilities

        • @[email protected]
          link
          fedilink
          24 months ago

          Element X for iOS, all right! Seemed to sync in ~5 Mississippi (~seconds) just now after setting it up when you first commented. Still some issues but seemingly better. Thanks!

    • @Norodix
      link
      44 months ago

      Correct me if Im wrong but only contributors can edit the wiki. If I remember correctly you cant just do a PR to the wiki. Which is sad.

      • Chewy
        link
        fedilink
        34 months ago

        It’s possible to allow anyone to edit a Github wiki. But I’m not sure whether edit permission can be set per page or wiki wide.

    • @hamFoilHat
      link
      24 months ago

      I’ve tried to use matrix… Is there a good matrix client? Like, one with admin commands? Maybe I just didn’t “get” it, but it seemed not even yet half baked.

    • @[email protected]
      link
      fedilink
      14 months ago

      I will never understand “forums are best”. I’ve tried, but they are worse in just about every aspect compared to any other communication system I’ve seen.

      People just like what they like, I guess.

      • @[email protected]
        link
        fedilink
        464 months ago

        The good thing about forums is that, once a problem is addressed, the solution remains there and is indexed by search engines for everyone to see. You can say anything about forums, but I doubt you never fixed some issue by looking at some old forum thread, without even having to bother anyone.

        • @[email protected]
          link
          fedilink
          14 months ago

          I have definitely solved the odd issue from forums… but only because forums were the only thing available. Reading through them is still a chore and a half. Especially when 90% of the posts are “has anyone found a solution for this yet” ad nauseum that you still have to scroll through to eventually (maybe) find the page with the post you actually need.

          I may just be bad at forums, but that’s been my experience with them for the last 20+ years.

      • @[email protected]
        link
        fedilink
        174 months ago

        Definitely use case specific.

        If you want to learn from a number of car enthusiasts how to address one specific error code with one specific model of car, is there anything better than finding a five page long forum thread and reading a few dozen posts about it from the last few years?

        • @[email protected]
          link
          fedilink
          14 months ago

          So like… “Forums are a good communication technology for modern use” and “have you ever found a solution in a forum” are different things.

          As a counterexample, I’ve had more luck finding weird ass computer hardware issue solutions by appending ‘reddit’ to a search string than just about anything else. On the other hand I’ve wasted hours and hours on forum threads that go nowhere, with a million dead ends, and terminates in “see this other thread for the actual answer” and then that thread is archived or otherwise inaccessible.

  • arthurpizza
    link
    English
    1594 months ago

    If the documentation is on discord, there is no documentation. Documentation has to be freely available, otherwise it doesn’t count.

    • @[email protected]
      link
      fedilink
      684 months ago

      Friendly reminder that open source projects don’t just need coders contributing to them.

      Technical writers are very appreciated.

      • TheHarpyEagle
        link
        24 months ago

        I’m trying to get my feet wet in FOSS by making small doc PRs since I’m way too scared to actually touch code. It’s not fun, but it is satisfying.

  • DreamButt
    link
    English
    1154 months ago

    How does everyone feel about the “isolation” of information exchange? Specifically with systems like discord which encourage you to congregate behind a wall? Historically things like community forums were open to the public and thus indexable.

    • @[email protected]
      link
      fedilink
      1204 months ago

      Hosting documentation on Discord is like hosting it on IRC.

      While a useful tool in its own right, it’s entirely the wrong choice for this job.

      • @tourist
        link
        644 months ago

        I have a strong suspicion that 90% of that shit is not being backed up. If a server gets deleted for whatever reason, all the documentation is extra gone with a side of never coming back.

        No wayback machine, no wget, no open source. Add in server moderators can go rogue or get hacked at any given time. Recipe for catastrophic shitshows

        • @kautau
          link
          384 months ago

          Discord provides no way to backup and restore a server. There are freemium third party products and some rudimentary open source tools that do so, but yeah, it’s wild how much information about open source software (this also applies to the game development community) is just in a proprietary walled garden with a single point of failure.

      • @[email protected]
        link
        fedilink
        174 months ago

        I’d say we left to plant a community garden. Anyone can see it, Anyone can join or start their own.

      • @kautau
        link
        94 months ago

        If it’s indexable it’s not a walled garden

      • oce 🐆
        link
        fedilink
        44 months ago

        We left because the previous garden is getting walled and this one isn’t.

  • callyral [he/they]
    link
    fedilink
    English
    994 months ago

    Documentation is different from technical support and neither should be done on Discord.

    • @cybersandwich
      link
      324 months ago

      Discord could be a decent place for technical support, the way irc used to be used, but unless it’s super active with knowledgeable, helpful people, forums/GitHub discussions and other asynchronous comms channels make way more sense.

      Otherwise it’s like shouting into the void and the signal to noise ratio on my discord channels is really low.

      Plus with forums and discussion boards they can be stickied and indexed to be searched. So the next time someone has that error message they can pull up that exact discussion.

      • @A_Random_Idiot
        link
        English
        564 months ago

        Discord is not a place for technical support or documentation, or anything important, ever.

        Search engines can not index discord.

        archive can not archive discord.

        Everything thats in discord, is in its own isolated bubble, that will disappear from history and time should the discord ever shut down, and even if its still up, its not findable by anyone searching for the problem.

        Discord fucking sucks for anything but random bullshiting with friends over games.

        • @merdaverse
          link
          254 months ago

          This. There are so many OSS projects that are over-reliant on Discord and it will bite them in the ass in a few years.

          • @A_Random_Idiot
            link
            English
            164 months ago

            and so many people are already searching for solutions to problems and cant find them, because they are locked away on discord.

            I fucking hate it.

            and its only gonna get worse with the years to come, as more data is centralized in discord and locked forever away from search engines, or worse, lost with the discord gets deleted or if the company goes under.

            and no ones saying to not have a discord. Just use it for what its meant to be used as. Social interaction. And stop using it for what it very obviously isnt, which is a information repository.

            as annoying as havin all the answers on reddit was, at least they popped up in a search engine so you could find an answer to what your problems were.

            • @merdaverse
              link
              3
              edit-2
              4 months ago

              and no ones saying to not have a discord. Just use it for what its meant to be used as. Social interaction. And stop using it for what it very obviously isnt, which is a information repository.

              Exactly. The problem is admins encourage it to be used for technical discussion as there are channels dedicated to that. And Discord has picked up on the need for structured discourse and have reinvented forums, just shittier and more closed.

              The way to prevent all this information going into a black hole is for admins to stop encouraging Discord for this kind of usage, in addition to users moving to more open alternatives. Godot for example is moving in the right direction. It has recently opened a shiny new Discourse instance, now the only thing that’s left is to burn the Discord forum with fire.

          • @[email protected]
            link
            fedilink
            8
            edit-2
            4 months ago

            I can’t wait until Discord have to start charging for features that are currently free (since they have to be profitable eventually), projects using it freak out about it, and end up switching to a different closed-source hosted system that’ll do the same thing years later. It already happened with OSS projects using Slack that migrated to Discord. People just don’t learn from the past.

  • Pika
    link
    fedilink
    English
    984 months ago

    It’s actually quite worrisome, many projects exclusively have their troubleshooting or support on Discord now what’s going to happen years down the road when all those Discord servers have closed or no longer active and the invite links expire this is going to be a vast knowledge base that’s just lost to the world

    • @[email protected]
      link
      fedilink
      574 months ago

      This is why going back to the moon is so hard, when msn groups closed back in the early 1970s we lost alot of very precious knowledge.

        • @Bondrewd
          link
          154 months ago

          No, there was MSN in the 70s but communication was made through a machine called Microtron. They are largely lost to the world due to being made from degradable PCB plates.

    • @clutchmatic
      link
      134 months ago

      That’s why FOSS ends up forking and forking

      • @Bondrewd
        link
        -3
        edit-2
        4 months ago

        Imagine “stealing” a project just because you can write sensible documentation.

        • @clutchmatic
          link
          84 months ago

          Another way to think about this is that those projects that have a more structured approach to documentation have a better chance at lasting longer, attracting more contributors, and making more lasting impacts

          • @Bondrewd
            link
            34 months ago

            What? We are talking about discord documented software.

        • TheHarpyEagle
          link
          44 months ago

          If it’s open source and the license allows it, I wouldn’t consider that stealing. If a fork gets more popular than the original, then it either addresses a major missing feature of the original or is simply more active. If this displeases the original dev, they can hopefully work it out with the maintainers of the fork. This is a feature of FOSS, not a bug.

    • @[email protected]
      link
      fedilink
      104 months ago

      I see your point, but couldn’t you say the same thing about any forum?

      “What happens when the forum shuts down? All threads discussing issues gone forever”

      • @[email protected]
        link
        fedilink
        464 months ago

        If you host a forum, you can easily access the database to move threads into some kind of archive if you no longer want to host it. It could also be moved to another server. Stuff like that.

        Using a proprietary service instead is just a bad idea.

      • @Evotech
        link
        294 months ago

        The web is on archive at least

  • @jaybone
    link
    954 months ago

    What the fuck happened to README.md.

    Or man pages.

    Or readme.txt.

    Or a goddamn wiki.

    • @[email protected]
      link
      fedilink
      584 months ago

      best I can do is please react to the #roles channel with a ❤️ to unlock the channel. what’s that? you’re looking for a fix to an issue you’re having in an older and supported version of the app? well sucks for you and suck my d*** we’ve already deleted that channel a long time ago who needs that old info anyway

      • @ikidd
        link
        English
        184 months ago

        I think we fixed that for someone a few months ago, maybe you can scroll back and find it. I think the guys handle was user-something, might have been around May…

  • @[email protected]
    link
    fedilink
    704 months ago

    Opened a discord link for info the other day…looked like a fucking Las Vegas casino. The.fuck.

  • @randon31415
    link
    444 months ago

    How to install:

    Step 1: git clone website

    Step 2: run dependency install script

    Step 2 again: Ha, ha, just kidding, that would be to straight forward. Please install this dependency installer program that only this and two other projects use. Pip grep panda cholotte poetry bash docker numpty anaconda jupternotebook alacazam. Oh, you don’t have it? Well, I’m sure the project page will tell you how to install it and add it to path!

    Step 3: Run " program name" and … “insanely detailed description of what to do once the program opens”

    Step 3 again: When you run it, get error “k*args passed null into program, so eat shit you can’t fix this”

    Step 4: Go to git hub issue page and see people have been complaining about this error for 6 months, but it was working back then when it’s 12 dependency hadn’t been updated yet. No fix incoming since the programmer was a chineese grad student that graduated 6 months ago and stopped working on the code.

    • @[email protected]
      link
      fedilink
      174 months ago

      This is why I like Docker. It’s basically “works on my machine” as a service.

      Similarly, I’m starting to really like dev containers. They’re Docker containers with all the required dev tools already installed inside, and a config so that VS Code knows how to spin up a new container when you want to do dev work on the project. They use VS Code remoting - a VS Code server runs in the container and the regular VS Code desktop app connects to it.

      I was recently dealing with a project that has some Ruby dev tools and it was 100x easier to deal with since they were using dev containers.

      • @Tenthrow
        link
        24 months ago

        Well now I need to learn all about this.

    • @[email protected]
      link
      fedilink
      7
      edit-2
      4 months ago

      YUP that’s so relatable especially with ai-related projects because theyre all on python

  • Anti-Face Weapon
    link
    274 months ago

    There are so many tools to make documentation for your project. LATEX is a great one, and you can use it to easily host your documentation online. And it’s really not difficult at all to do by hand. If you can have it on discord you can certainly have it in a repo.

    Maybe it’s a cynical ploy to increase community engagement with their project by getting them into the discord. Regardless, it gives me The Ick. Very gross.

    • @renzevOP
      link
      English
      374 months ago

      LaTeX is great, but I prefer Markdown for software documentation (bonus points if your flavor of markdown supports LaTeX-style math). Standard LaTeX is geared towards typesetting and formatting, which is great for reports and journals, but not so much for software documentation, so you end up with a lot of boilerplate. Markdown syntax is also more accessible to beginners, I feel. And if you have a really big project that requires features like cross-references, there’s things like myst markdown.

      • Anti-Face Weapon
        link
        104 months ago

        Both are powerful tools, though with different strengths as you describe. I was thinking more with automation in mind. But regardless, anything is better than a discord server. Even .txt documentation!

    • Chewy
      link
      fedilink
      94 months ago

      I personally don’t like LaTeX for documentation because it doesn’t benefit much from advanced features of LaTeX, while being more difficult to read/write than Markdown.

      Discord is great for building a community because it’s the defacto chat service for communities. It replaced IRC and does that quite well. Having a place to casually chat with people more invested in the project has its advantages.

      Now I really dislike it if they think discord can replace a wiki. Iirc discord added a wiki-like feature a while ago and it’s terrible because it’s not indexable by search engines.

      • Anti-Face Weapon
        link
        214 months ago

        I think you give Discord too much credit even with that. They’re closed source and have very little openness with their data. We have no clue how they store and archive our data and conversations, or what they do with it. I don’t think the open source community should trust Discord an inch.

        I’m really hoping an open source alternative starts gaining traction.

        • Chewy
          link
          fedilink
          34 months ago

          A agree with everything you just wrote. Discord is the platform of choice for many projects because most people are already there, so it increases engagement (and often enough some people actually ask for an official discord).

          I personally prefer projects to use matrix, despite all it’s faults. Some already do.

          • Anti-Face Weapon
            link
            14 months ago

            I’ve not heard of matrix before. Looking it up, it looks pretty cool. Kind of a terrible name tbh.

      • Anti-Face Weapon
        link
        134 months ago

        LaTeX can produce .html with links. It can litterally generate an entire documentation website.

    • @jj4211
      link
      44 months ago

      It’s not really about the tools, we have plenty of tools, plain text, markdown, latex, web pages. Putting content to readable format is the easy part.

      The hard part is knowing what to put down and how to organize it, and making sure that your documented explanations are actually understandable.

      Particularly when you want to get traction going you might really want conversations to help you understand where the project needs fixing versus how documentation needs fixing and get a sense for what documentation might be helpful.