this post was submitted on 28 Jan 2024
2036 points (98.2% liked)

linuxmemes

21410 readers
916 users here now

Hint: :q!


Sister communities:


Community rules (click to expand)

1. Follow the site-wide rules

2. Be civil
  • Understand the difference between a joke and an insult.
  • Do not harrass or attack members of the community for any reason.
  • Leave remarks of "peasantry" to the PCMR community. If you dislike an OS/service/application, attack the thing you dislike, not the individuals who use it. Some people may not have a choice.
  • Bigotry will not be tolerated.
  • These rules are somewhat loosened when the subject is a public figure. Still, do not attack their person or incite harrassment.
  • 3. Post Linux-related content
  • Including Unix and BSD.
  • Non-Linux content is acceptable as long as it makes a reference to Linux. For example, the poorly made mockery of sudo in Windows.
  • No porn. Even if you watch it on a Linux machine.
  • 4. No recent reposts
  • Everybody uses Arch btw, can't quit Vim, and wants to interject for a moment. You can stop now.
  •  

    Please report posts and comments that break these rules!


    Important: never execute code or follow advice that you don't understand or can't verify, especially here. The word of the day is credibility. This is a meme community -- even the most helpful comments might just be shitposts that can damage your system. Be aware, be smart, don't fork-bomb your computer.

    founded 1 year ago
    MODERATORS
     
    top 50 comments
    sorted by: hot top controversial new old
    [–] JoMiran@lemmy.ml 347 points 10 months ago (3 children)

    One of the stupidest trends of all time.

    [–] Zeon@lemmy.world 86 points 10 months ago* (last edited 10 months ago) (6 children)

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

    [–] Kecessa@sh.itjust.works 153 points 10 months ago (9 children)

    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.

    load more comments (9 replies)
    [–] JoMiran@lemmy.ml 61 points 10 months ago (5 children)

    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.

    [–] flamingos@ukfli.uk 43 points 10 months ago (1 children)

    Aren't you basically describing readthedocs.io?

    load more comments (1 replies)
    [–] Babbiorsetto@lemmy.sdf.org 21 points 10 months ago

    First thing that comes to mind is https://devdocs.io/about

    load more comments (3 replies)
    [–] Treczoks@lemmy.world 36 points 10 months ago (1 children)

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

    load more comments (1 replies)
    load more comments (3 replies)
    load more comments (2 replies)
    [–] OneCardboardBox@lemmy.sdf.org 241 points 10 months ago (2 children)

    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 53 points 10 months ago (6 children)

    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.

    load more comments (6 replies)
    load more comments (1 replies)
    [–] DirkMcCallahan@lemmy.world 166 points 10 months ago (30 children)

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

    [–] voxelastronaut@lemmy.world 106 points 10 months ago (9 children)

    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.

    load more comments (9 replies)
    [–] soggy_kitty@sopuli.xyz 65 points 10 months ago* (last edited 10 months ago) (3 children)

    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

    load more comments (3 replies)
    [–] wholemilk@lemm.ee 56 points 10 months ago (5 children)

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

    load more comments (5 replies)
    load more comments (27 replies)
    [–] LainOfTheWired@lemy.lol 163 points 10 months ago (14 children)

    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.

    [–] brbposting@sh.itjust.works 24 points 10 months ago (4 children)

    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.

    load more comments (4 replies)
    load more comments (13 replies)
    [–] art@lemmy.world 160 points 10 months ago (1 children)

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

    [–] JasonDJ@lemmy.zip 68 points 10 months ago (1 children)

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

    Technical writers are very appreciated.

    load more comments (1 replies)
    [–] kittenzrulz123@lemmy.world 127 points 10 months ago
    [–] tdawg@lemmy.world 115 points 10 months ago (7 children)

    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.

    [–] Godort@lemm.ee 120 points 10 months ago (1 children)

    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@lemmy.world 64 points 10 months ago (2 children)

    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@lemmy.world 38 points 10 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.

    load more comments (1 replies)
    load more comments (6 replies)
    [–] callyral@pawb.social 100 points 10 months ago (1 children)

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

    [–] cybersandwich@lemmy.world 32 points 10 months ago (1 children)

    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@lemmy.world 57 points 10 months ago (1 children)

    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@lemmy.world 25 points 10 months ago (3 children)

    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.

    load more comments (3 replies)
    [–] Pika@sh.itjust.works 98 points 10 months ago (11 children)

    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

    [–] Hootz@lemmy.ca 57 points 10 months ago (3 children)

    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.

    load more comments (3 replies)
    load more comments (10 replies)
    [–] jaybone@lemmy.world 95 points 10 months ago (1 children)

    What the fuck happened to README.md.

    Or man pages.

    Or readme.txt.

    Or a goddamn wiki.

    [–] ARk@lemm.ee 58 points 10 months ago (2 children)

    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

    load more comments (2 replies)
    [–] skeptomatic@lemmy.ca 70 points 10 months ago

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

    [–] randon31415@lemmy.world 44 points 10 months ago (3 children)

    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.

    load more comments (3 replies)
    [–] FiskFisk33@startrek.website 33 points 10 months ago

    If it's not search indexable it can go eat dirt

    [–] avidamoeba@lemmy.ca 32 points 10 months ago

    Never clicked on one of those Discord links, never will.

    [–] Anti_Face_Weapon@lemmy.world 27 points 10 months ago (8 children)

    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.

    [–] renzev@lemmy.world 37 points 10 months ago (1 children)

    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.

    load more comments (1 replies)
    load more comments (7 replies)
    [–] Crafter72@lemmy.world 26 points 10 months ago* (last edited 10 months ago) (1 children)

    Imo this kind stuff probably because these "dev" having safe space on those discord servers rather than using something properly setup site/forum.

    Heck you can make your own documentation using github/gitlab built in wiki or if you want something fancier, setup a site using JAMstack/static site generator, pick suitable theme then use gh page to host it.

    I even more hate this stuff when the files is gated inside discord server, dude out of all possible file hosting services why the heck you would use discord?

    load more comments (1 replies)
    [–] flatpandisk@lemm.ee 26 points 10 months ago (6 children)

    I have been lucky and haven’t seen this. What a horrible thing to do.

    load more comments (6 replies)
    load more comments
    view more: next ›