Lemmy/Reddit style platforms are good at generating short term discussions, it’s threaded chats.
The main features that makes forums the best to accumulate knowledge is bumping and linear discussions. There’s only one discussion that everyone is following if they want to talk about a specific subject, the knowledge on that subject is centralized and keeps accumulating instead of requiring to be constantly repeated because the previous thread is lost to time. The linear discussion means you don’t have to go back up and start reading a different branch to know what some other people are talking about (which often times leads to having many people basically saying the same thing without realizing it), all new replies appear in chronological order and people quote others to provide context when necessary.
Look on old school forums for more “boomer hobbies” and it’s ridiculous how long conversations can keep going. I provided a link in another reply but the Yamaha WR250 thread on ADVRider has 428k replies since 2013, all that is possible to know about this motorcycle is in they thread and pretty much any question you might have will have its reply in there. There’s car forums with discussions that have been ongoing for decadeS!
Meanwhile on Reddit of you want to ask a question in a thread that was started 24h ago you’re shit out of luck, no one but the OP will know about it. On Lemmy? Everyone sorts by top 6 hours.
I have been playing with the idea of a documentation.org. Something publicly funded (mostly through corporate and individual donations) that hosts technical manuals, white papers, guides, links to video tutorials (likely YouTube), FAQs, and even links to Discord and/or forums if they exist. Documents are public, free to index (no login to view), version controlled and held in perpetuity.
Obviously there is much more to it, but I think we have reached a point where something like it is required.
In the most technical terms, yes. The idea is not new or bizarre, but I see the same missteps repeated. For starters, the venture HAS to be a nonprofit with zero need for monetization. It will also need an inviting and easy to navigate user interface, accessible to the most nontechnical of users. You need to have a massive document library from multiple large players from day one, so you need to have a lot of contacts.
As I said it’s not fully cooked, but I have spoken to a few people that could help me make it happen and they seemed open to it.
Please consider a Patreon for doc review. I don’t mean reviewing the doc against the project for fitness, as that’s the job of each project to maintain and review their own docs; I mean by a technical writer who can de-localize (you only think I mean ‘internationalize’) the document and make it syntactically and logically correct against a generic, classic style guide.
The rising popularity of really bad errors is definitely turning me off from videos or documentation from a few sources with a lot of churn. It ruins the flow and it robs the assumption of authority which I’d argue is an important part of any documentation.
That is a good idea. I am fairly certain I could get funding and/or loaned resource time for English, Spanish, French and German, but crowd funding incentivized localization for other regions is brilliant.
one time, I asked and got a reply that it has been answered already, followed by a rant of why the hell people were asking the same question over and over again. IDK man, maybe you could update the installation instructions in your readme, then people wouldn’t be flodding discord with the same question over and over again.
(it was regarding the project being incompatible with the newest version of a library and you had to manually install an older version to get it to work)
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.
IRC at least you have text logs, but I agree.
we just need IRCv2 which should add chat history
How do you replicate a conversation like this in a IRC format?
https://www.advrider.com/f/threads/yamaha-wr250r-threadfest.936588/
Where’s lemmy in regards to this?
Lemmy/Reddit style platforms are good at generating short term discussions, it’s threaded chats.
The main features that makes forums the best to accumulate knowledge is bumping and linear discussions. There’s only one discussion that everyone is following if they want to talk about a specific subject, the knowledge on that subject is centralized and keeps accumulating instead of requiring to be constantly repeated because the previous thread is lost to time. The linear discussion means you don’t have to go back up and start reading a different branch to know what some other people are talking about (which often times leads to having many people basically saying the same thing without realizing it), all new replies appear in chronological order and people quote others to provide context when necessary.
Look on old school forums for more “boomer hobbies” and it’s ridiculous how long conversations can keep going. I provided a link in another reply but the Yamaha WR250 thread on ADVRider has 428k replies since 2013, all that is possible to know about this motorcycle is in they thread and pretty much any question you might have will have its reply in there. There’s car forums with discussions that have been ongoing for decadeS!
Meanwhile on Reddit of you want to ask a question in a thread that was started 24h ago you’re shit out of luck, no one but the OP will know about it. On Lemmy? Everyone sorts by top 6 hours.
I have been playing with the idea of a documentation.org. Something publicly funded (mostly through corporate and individual donations) that hosts technical manuals, white papers, guides, links to video tutorials (likely YouTube), FAQs, and even links to Discord and/or forums if they exist. Documents are public, free to index (no login to view), version controlled and held in perpetuity.
Obviously there is much more to it, but I think we have reached a point where something like it is required.
Aren’t you basically describing readthedocs.io?
In the most technical terms, yes. The idea is not new or bizarre, but I see the same missteps repeated. For starters, the venture HAS to be a nonprofit with zero need for monetization. It will also need an inviting and easy to navigate user interface, accessible to the most nontechnical of users. You need to have a massive document library from multiple large players from day one, so you need to have a lot of contacts.
As I said it’s not fully cooked, but I have spoken to a few people that could help me make it happen and they seemed open to it.
First thing that comes to mind is https://devdocs.io/about
Please consider a Patreon for doc review. I don’t mean reviewing the doc against the project for fitness, as that’s the job of each project to maintain and review their own docs; I mean by a technical writer who can de-localize (you only think I mean ‘internationalize’) the document and make it syntactically and logically correct against a generic, classic style guide.
The rising popularity of really bad errors is definitely turning me off from videos or documentation from a few sources with a lot of churn. It ruins the flow and it robs the assumption of authority which I’d argue is an important part of any documentation.
That is a good idea. I am fairly certain I could get funding and/or loaned resource time for English, Spanish, French and German, but crowd funding incentivized localization for other regions is brilliant.
Also I’d rather just have these things in the repository.
That’s not the point. The point is that pointing to Discord means that there simply is no documentation.
I meant it more as a communication platform, not nescessarily for hosting documentation. Either way, using a forum is still pretty good alternative
Removed by mod
I only want the documentation if you have to fax it to me
Whatever, Mr. Stallman.
The very fact that you have to ask and wait for an answer is an inconvenience.
one time, I asked and got a reply that it has been answered already, followed by a rant of why the hell people were asking the same question over and over again. IDK man, maybe you could update the installation instructions in your readme, then people wouldn’t be flodding discord with the same question over and over again.
(it was regarding the project being incompatible with the newest version of a library and you had to manually install an older version to get it to work)