2 ms·

> And yet you point me to a YouTube video, rather than a link on their website. So you can see it > and yet, the documentation doesn't seem to describe, in fr

• 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...