8 points

I am already happy if there is any documentation at all. And I am euphoric if it doesn’t suck, i.e. sufficiently detailed and up to date.

So I guess Discord is better than nothing. But sure it’s a turn off.

permalink
report
reply
4 points

Log into discord, copy the documentation and create a PR with it. (Or make a wiki?)

permalink
report
parent
reply
35 points

My biggest nightmare is one day you will go on to a random website and when you press “contact us” it opens an invite to a discord server.

permalink
report
reply
9 points

or better yet a QR code to scan in the Discord App. Great way to get your account credentials stolen

permalink
report
parent
reply
7 points

You old farts should keep up with times. /s

permalink
report
reply
3 points

Preach!

permalink
report
reply
46 points

I’ve literally never seen a project remotely interesting that has their documentation on discord

permalink
report
reply
19 points

Revanced was one. Good thing they wisen up and have documentations now, though it’s just a set of .md files in their git repo.

permalink
report
parent
reply
2 points

what is it

permalink
report
parent
reply
4 points

Modded version of youtube app that let’s you kill all the ads, among many other wonderful features. However, every 6 months or so, youtube does something where the videos stop loading effectively killing the app. I usually switch between vanced and revanced every 6 or so months because one has so far always worked when the other gets the axe. By the time that one goes down, the other one is back up and running.

permalink
report
parent
reply
26 points

Markdown in the repository is a pretty good way to keep documentation in sync with the source.

permalink
report
parent
reply
2 points

The Gagguino project is a counterpoint to this. They have some extremely limited documentation, but to really build one you probably are going to need to dig into Discord. I hate it. The project is really cool, though, and I’m building one right now.

permalink
report
parent
reply
20 points

To be fair, I could say the same, but is probably a biased sample.

I have other red flags, like only distributing on docker, that I’ve tried, and tried again, and found that it’s a sign of a badly run project. But I can’t state any confidence on the discord based rule, because I’ve never tried to make any run.

permalink
report
parent
reply
14 points

The docker thing really grinds my gears. I see it as the ultimate “works on my machine” mentality. Basically they can’t be arsed to write software that is robust to changes in hosting platform.

permalink
report
parent
reply
3 points

I have dealt with “only works in kubernetes” because developers couldn’t be bothered to make it even work on docker without all the hidden orchestration.

So, instead of documentation, they just make the service work in that one specific environment.

permalink
report
parent
reply

Programmer Humor

!programmerhumor@lemmy.ml

Create post

Post funny things about programming here! (Or just rant about your favourite programming language.)

Rules:

  • Posts must be relevant to programming, programmers, or computer science.
  • No NSFW content.
  • Jokes must be in good taste. No hate speech, bigotry, etc.

Community stats

  • 6.9K

    Monthly active users

  • 1.5K

    Posts

  • 34K

    Comments