using discord for documentation is like using excel for a database
It’s way worse. At least Excel lets you do database-like stuff. Discord is unusable for long-form posts or any info you want to keep long term.
still worse They own everything you write on discord
Yes, this exactly! I still cannot fathom how Discord took off. It offers literally no advantages over forums, and introduces some massive disadvantages.
You don’t see its incredible simplicity as an advantage? That’s crazy
Counterpoint
Counter-counterpoint: He did eat something off his foot in front of an audience.
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.
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.
LaTeX produces PDFs, which are hard to read on small devices. Just write a website.
LaTeX can produce .html with links. It can litterally generate an entire documentation website.
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
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…
Reading this made me feel a bit of anxiety
One of the stupidest trends of all time.
There is FOSS alternatives out there like Revolt or just plain old IRC which is good enough imo. The Discord bullshit is so annoying.
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.
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.
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.
