3 ms·

Honestly, the matrix documentation is a total mess in general. The protocol is from what I can tell pretty cleverly designed/usable as a casual chat app (even

Honestly, the matrix documentation is a total mess in general. The protocol is from what I can tell pretty cleverly designed/usable as a casual chat app (even if it leans heavily towards IRC esque design), but actually figuring out how to use it is somewhere between "wisdom of the ancients" and actually impossible. A lot of very relevant information is stored in old documentation that is currently marked as outdated on the site but has no updated equivalent. The bad apps and onboarding only hamper it further. It's still baffling to me that the best way to actually administer a selfhosted matrix homeserver (specifically, synapse, the reference homeserver) is to do a database hack to promote a user to an admin and then use an external PWA hosted on GitHub[0] so you can actually do basic moderation actions without having to resort to using curl. [0]: https://awesome-technologies.github.io/synapse-admin/ https://awesome-technologies.github.io/synapse-admin/

thibaultamartin 3y ago
Indeed the documentation generally needs much more love. In an ideal world, every single page of the documentation would have a person in charge of keeping it up to date. We're a rather small team on the Foundation side and lack the personpower to do so. We're in the process of listing what documentation we need and what we need to update. This will be the foundational work to apply to Google Summer of Docs and for individual tech writers to apply to grants like NLNet (who doesn't usually fund "large" organisations like us) to help us out. I'm also adding instructions on how people can step in and contribute to the docs if they have the time and desire to do so: https://github.com/matrix-org/matrix.org/pull/2155 https://github.com/matrix-org/matrix.org/pull/2155 We're doing our best with our limited resources, but I'm confident we can improve the situation eventually!

thibaultamartin 3y ago

Indeed the documentation generally needs much more love. In an ideal world, every single page of the documentation would have a person in charge of keeping it up to date. We're a rather small team on the Foundation side and lack the personpower to do so. We're in the process of listing what documentation we need and what we need to update. This will be the foundational work to apply to Google Summer of Docs and for individual tech writers to apply to grants like NLNet (who doesn't usually fund "large" organisations like us) to help us out. I'm also adding instructions on how people can step in and contribute to the docs if they have the time and desire to do so: https://github.com/matrix-org/matrix.org/pull/2155 https://github.com/matrix-org/matrix.org/pull/2155 We're doing our best with our limited resources, but I'm confident we can improve the situation eventually!