This is often done by people while the project is unstable. No need to write documentation that gets outdated every few weeks, when you can help people live in discord.
There needs to be some plan to migrate to stable documentation at some point though.
Hell, even a small traditional forum is better searchable.
What I see happen is that the people with the knowledge get so busy answering questions in discord that it impacts the efforts on documentation and on the software itself.
Or if you find the project a while later, and the link/server is dead, either because the maintainer forgot to update the link, or the server shut down/removed invites for some reason, like spam prevention.
Zulip is a little better in this regard. I’m involved in Lean, which uses Zulip as the primary mode of support and documentation. While it’s usable, I still think that a Discourse style forum is the way to go.
D*scord is technically searchable and fairly archiveable (messages never get deleted due to old age (in my experience at least) or if the original poster deletes their account). And some d*scord servers even have a Q&A mode similar to st*ck *verflow. But yeah, not the right tool for the job, not to mention ＡＢＳＯＬＵＴＥＬＹ ＰＲＯＰＲＩＥＴＡＲＹ
Same reasons you’d censor profanity. To show that I don’t necessarily agree with or support them. Maybe I should start using the vomit emoji instead of asterisks like u/pancakes [joking].
To me it comes off like you’re irrationally afraid to invoke its name.
I get and appreciate that you’re trying to make a statement here, but in my opinion it isn’t landing the way you think it is. By giving its name special reverence you’re needlessly elevating it, not diminishing it.
This is often done by people while the project is unstable. No need to write documentation that gets outdated every few weeks, when you can help people live in discord.
There needs to be some plan to migrate to stable documentation at some point though.
Hell, even a small traditional forum is better searchable.
What I see happen is that the people with the knowledge get so busy answering questions in discord that it impacts the efforts on documentation and on the software itself.
That live support is super handy when you’re 8 timezones apart from the maintainers.
11 hours later
6 hours later
Or if you find the project a while later, and the link/server is dead, either because the maintainer forgot to update the link, or the server shut down/removed invites for some reason, like spam prevention.
thats understandable but at least use something searchable that has tagging capabilities and is archivable so that you can come back to it years later
Zulip is a little better in this regard. I’m involved in Lean, which uses Zulip as the primary mode of support and documentation. While it’s usable, I still think that a Discourse style forum is the way to go.
D*scord is technically searchable and fairly archiveable (messages never get deleted due to old age (in my experience at least) or if the original poster deletes their account). And some d*scord servers even have a Q&A mode similar to st*ck *verflow. But yeah, not the right tool for the job, not to mention ＡＢＳＯＬＵＴＥＬＹ ＰＲＯＰＲＩＥＴＡＲＹ
I’ve never seen Discord messages turn up in any Google or DuckDuckGo search
Kinda tempted to make a bot that automatically joins d*scord servers, indexes all the messages, and publishes them to a public website
I think what they really mean is searchable without an account, but otherwise you’re right.
But also Discord search is catastrophically bad and won’t find lots of matches.
Or find lots of things that aren’t matches because it’s a fuzzy search with no way to search for exact text.
Why are you redacting platform names like it’s profanity? My brain keeps trying to read it as markdown…
Same reasons you’d censor profanity. To show that I don’t necessarily agree with or support them. Maybe I should start using the vomit emoji instead of asterisks like u/pancakes [joking].
Well that’s just fucking bullshit.
To me it comes off like you’re irrationally afraid to invoke its name.
I get and appreciate that you’re trying to make a statement here, but in my opinion it isn’t landing the way you think it is. By giving its name special reverence you’re needlessly elevating it, not diminishing it.
https://tenor.com/7cqP.gif