Discord != Documentation
Discord != Documentation
You're viewing a single thread.
143 comments
-
I recently built a 3D printer where the entire community for it lives on Discord. Their website instructions are horrifically out of date because all of the current changes have been discussed at some point on Discord. What should have been a 2-4 day project turned into a 2-3 week project due to the garbage involved in trying to strain information out of a massive multi-channel group chat with terrible search.
-
It wastes everyone's time. The project maintainers have to keep answering the same questions, and the users don't have instant access to answers
-
Why would any sane developer want to use this system to "document" their project? Written docs have worked well for a million years and there's no need to change them.
-
You can even include them in your version control system and allow others to suggest changes
-
And you can include separate ones right there in the root folder where the script lives. README.md renders out beautifully on GitHub.
-
-
-
-
What 3d printer is this so I can avoid it?
-
I’m afraid they’re talking about the Voron printers, which are really great printers.
-
The instructions on the Web are pretty good, unless you start messing with Tons of mods, but thats your own fault.
-
True, but they have access to so many better ways of documenting stuff…
-
-
You're probably right, but I can think of a couple other 3d printing projects that have the same issue.
-
-
-
What printer is this so I can avoid it?
-
Poor bastard. I feel you. 💐
-
143 comments