2 ms·
Watching that video now. I can say, without a doubt and with great seriousness, that if you have any control over their documentation process, in the "getting
by t-writescode 6y ago
Watching that video now.
I can say, without a doubt and with great seriousness, that if you have any control over their documentation process, in the "getting started" and "setting up synapse for yourself" pages, that video should ABSOLUTELY be a part of that. It is orders of magnitude easier to follow.
> mind to expand that?
Imagine you don't know how to use nginx.
Okay, now try to read ANYTHING in any of the numerous github .md files.
Then, just start with this page:
https://github.com/matrix-org/synapse https://github.com/matrix-org/synapse
What's Synapse? You know, I know now; but, where on that page does it say what Synapse is?
On basically every tutorial page, I think there's value in asking "okay, what do I need to know to understand this page?" If the knowledge is important and takes more than a click or maybe two to get that answer, it's too far away for most people, I think.
Again, the YouTube video walking through the steps with the guy talking is AMAZING. I've learned more listening to this than any number of web pages attempting to describe it.
Edit: I find the federation documentation to be very confusing, as well: https://github.com/matrix-org/synapse/blob/develop/docs/federate.md https://github.com/matrix-org/synapse/blob/develop/docs/fede...