Rename Docs to "Learn Matrix" and add it to the Try Matrix page #2555
Conversation
|
I was comparing the m.org website's categories to where other projects might have "Learn more" and "Get started" sections. To me, "Docs" sounds too dry and not interesting to actually read, but more technical - when actually we want it to be end user facing docs that go a little beyond "getting started" (i.e. jumping in head first to try it out). We should also clean the section's contents itself up. I find it does not fit the way the rest of the website is designed and the mix of "Matrix for chat" and "Spec guide for implementing authenticated media in the federation API" don't at all fit together. |
|
Point taken and I agree that Docs is a bit try. I'm wondering if "Learning Matrix" is really more engaging though. Could something along the lines of "Get started" or "Use Matrix" make more sense? |
There was a problem hiding this comment.
Left a few nits here and there, nothing too significant.
As an aside, the handbook svg doesn't look fantastic but in all fairness all the pictures on the existing page are not exactly great either.
We will have to request some Jordan time to get nicer illustrations, but that's not a blocker for this PR.
Deploying matrix-website with
|
| Latest commit: |
a3ac446
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://8c076c4e.matrix-website.pages.dev |
| Branch Preview URL: | https://mtrnord-docs-learn.matrix-website.pages.dev |
This is a result of a discussion with @HarHarLinks .
The icon illustration is the Gnome UI Icon "document-text" which is CC Zero licensed and was modified to fit the same corner style like the other illustrations. However I would prefer a proper illustration here instead.