Rename Docs to "Learn Matrix" and add it to the Try Matrix page

content/docs/_index.md

@@ -1,5 +1,5 @@
 +++
-title = "Documentation"
+title = "Learn Matrix"
 render = false
-extra.updated = "2022-10-18T16:00:00Z"
+extra.updated = "2024-11-09T16:00:00Z"
 +++

navigation.toml

@@ -2,7 +2,7 @@ header = [
     { title = "Spec", href = "https://spec.matrix.org" },
     { title = "Foundation", section = "foundation" },
     { title = "Blog", href = "/blog/" },
-    { title = "Docs", href = "/docs/" },
+    { title = "Learn Matrix", href = "/docs/" },
     { title = "Ecosystem", section = "ecosystem" },
     { title = "Donate", href = "/support" },
     { title = "Try Matrix", href = "/try-matrix/", primary = true },

static/_redirects

@@ -107,6 +107,10 @@
 # Unbreaking Synapse links, see https://github.com/matrix-org/synapse/issues/15825
 /docs/projects/try-matrix-now.html /ecosystem/clients
 
+# Prevent in-browser redirect by doing a server side redirect instead for docs
+/docs /docs/chat_basics/matrix-for-im/
+/docs/ /docs/chat_basics/matrix-for-im/
+
 #####################################################
 ## Dynamic redirects (100 limit, first match wins) ##
 ##      Keep these below the static redirects      ##

templates/try-matrix.html

@@ -9,6 +9,26 @@ <h1>{{ page.title }}</h1>
 
 <div class="try_matrix">
     <div class="step-background">
+        <div class="step choose-a-client">
+            <div class="instructions">
+                <h3>Learn about Matrix</h3>
+                <p>
+                    We have a variety of resources to help you learn about Matrix and how it works.
+                </p>
+                <p>
+                    If you're new to Matrix, we recommend starting with the <a
+                        href="/docs/chat_basics/matrix-for-im/">Matrix for Instant Messaging Guide</a>.
+                </p>
+                <div class="cta-wrapper">
+                    <a href="/docs" class="call-to-action">Learn Matrix</a>
+                    <a href="/docs/communities/getting-started/" class="call-to-action secondary">Build a Community on
+                        Matrix</a>
+                </div>
+            </div>
+            <img src="/assets/try-matrix/handbook.svg" alt="Artist view of an abstract matrix client." />
+        </div>
+    </div>
+    <div class="step-background coloured">
         <div class="step choose-a-client">
             <div class="instructions">
                 <h3>Choose a client</h3>
@@ -23,7 +43,7 @@ <h3>Choose a client</h3>
             <img src="/assets/try-matrix/client.svg" alt="Artist view of an abstract matrix client." />
         </div>
     </div>
-    <div class="step-background coloured">
+    <div class="step-background">
         <div class="step choose-a-server">
             <div class="instructions">
                 <h3>Choose a server</h3>
@@ -45,7 +65,7 @@ <h3>Choose a server</h3>
             <img src="/assets/try-matrix/server.svg" alt="Artist view of an abstract server." />
         </div>
     </div>
-    <div class="step-background">
+    <div class="step-background coloured">
         <div class="step register-and-chat">
             <div class="instructions">
                 <h3>Register and start chatting</h3>
@@ -63,4 +83,4 @@ <h3>Register and start chatting</h3>
         </div>
     </div>
 </div>
-{% endblock content %}
+{% endblock content %}