Totally agree, please let the doc be doc, not a chat.
PS: what were the original subtitles of the screenshot? :)
Fuck Discord.
I just tried asking a question yesterday, and realized there's basically no way to save / bookmark / whatever a specific thing... it's seriously just a fucking chat room.
Yeah it's literally just that. I still have no idea why it's used as some kind of database by so many
It's great for what it's intended for, a gaming voice/text chat server.
Seriously fuck discord
To be fair, a discord comment from five years ago is still more helpful than Amazon AWS's actual documentation.
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!!
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.
Post funny things about programming here! (Or just rant about your favourite programming language.)
