To be fair, a discord comment from five years ago is still more helpful than Amazon AWS's actual documentation.
this post was submitted on 28 Jul 2023
989 points (99.1% liked)
Programmer Humor
32410 readers
1 users here now
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.
founded 5 years ago
MODERATORS
I'm not 41 yet, but even if you csn somehow make a chat room app replace the functionality of code documentation or a few simple example code snippets... should you? You're also hosting on GitHub and not on MEGA, even though you could...
Pull requests welcome!!
RTFD, or something like that.
I think you mean RTFM. But in this case it's WTFM so I can RTFM.
No, i think op is saying RTFD as in "read the fucking discord"
Ah, in that case we need something like MTFDS, make the fucking discord searchable.
I'm usually on the documenting side of things. If something like this starts unfolding, I produce text or HTML files anyway, they go on github/lab/whatever, and I wash my hands of what happens next.
In the end I write documentation mostly for myself. When the company can't figure things out over Discord or whatever ephemeral chat interface they use, I get called anyway.
> I produce text or HTML files anyway
I do extensive in-code documentation. The compiler discards all comments so I don't worry about commenting my code. Source code is for humans to understand and write anyways.
Oh, yeah. My source code is like 60% comments by weight (or more). Although I typically produce separate standalone documentation for management or semi-technical staff. You know, people who know enough to possibly break something, but not enough to fix it afterward. I find it useful when trying to train new people too.
User-facing documentation is a completely different thing, yes.
load more comments
(1 replies)
Matrix chat as the core developer hangout I find is similar
Also, putting documentation in a format that has way too many features so just reading docs takes up 40% of CPU usage. Yes ,fuck you for using gitbook, i hate it so fucking much
The only real alternatives to Discord is Matrix and Revolt. I am on both and there are a good number of people on there but they aren't too active. Wish they would be more popular and widely used
No love for Mattermost?
load more comments
(3 replies)