Restructured the realtime docs (#2317)

* Reordered react hooks + frontend sections

* Updated the overview and nav

* Separated out SWR hooks

* Restructured metadata sections

* Improved backend docs

* Fixed broken link

* Fixed broken links

* Updated the structure

* Restructured overview

* Updated examples cards

* Improved overview

* Updated how it works

* Updated auth

* Added type safety to the run object page

* made the subscribe description clearer

* Fixed links in triggering

* Fixed link

* Removed examples footers

* Copy tweak

* Consolidated metadata and subscribe pages

* moved metadata task examples to metadata

* Fixed links

* Fixing links like zelda

* Removed dead import

* Clearer titles

* Cap R for Realtime

* Fixes broken link

---------

Co-authored-by: James Ritchie <[email protected]>

Author: D-K-P

docs/docs.json

@@ -131,30 +131,32 @@
             ]
           },
           {
-            "group": "Frontend usage",
+            "group": "Realtime",
             "pages": [
-              "frontend/overview",
+              "realtime/overview",
+              "realtime/how-it-works",
+              "realtime/run-object",
+              "realtime/auth",
+              {
+                "group": "React hooks (frontend)",
+                "pages": [
+                  "realtime/react-hooks/overview",
+                  "realtime/react-hooks/triggering",
+                  "realtime/react-hooks/subscribe",
+                  "realtime/react-hooks/streams",
+                  "realtime/react-hooks/swr"
+                ]
+              },
               {
-                "group": "React hooks",
+                "group": "Backend",
                 "pages": [
-                  "frontend/react-hooks/overview",
-                  "frontend/react-hooks/realtime",
-                  "frontend/react-hooks/triggering"
+                  "realtime/backend/overview",
+                  "realtime/backend/subscribe",
+                  "realtime/backend/streams"
                 ]
               }
             ]
           },
-          {
-            "group": "Realtime API",
-            "pages": [
-              "realtime/overview",
-              "realtime/streams",
-              "realtime/react-hooks",
-              "realtime/subscribe-to-run",
-              "realtime/subscribe-to-runs-with-tag",
-              "realtime/subscribe-to-batch"
-            ]
-          },
           {
             "group": "CLI",
             "pages": [
@@ -621,7 +623,47 @@
     },
     {
       "source": "/frontend/react-hooks",
-      "destination": "/frontend/react-hooks/overview"
+      "destination": "/realtime/react-hooks/overview"
+    },
+    {
+      "source": "/frontend/overview",
+      "destination": "/realtime/auth"
+    },
+    {
+      "source": "/frontend/react-hooks/overview",
+      "destination": "/realtime/react-hooks/overview"
+    },
+    {
+      "source": "/frontend/react-hooks/realtime",
+      "destination": "/realtime/react-hooks/realtime"
+    },
+    {
+      "source": "/frontend/react-hooks/triggering",
+      "destination": "/realtime/react-hooks/triggering"
+    },
+    {
+      "source": "/realtime/backend",
+      "destination": "/realtime/backend/overview"
+    },
+    {
+      "source": "/realtime/streams",
+      "destination": "/realtime/backend/streams"
+    },
+    {
+      "source": "/realtime/react-hooks",
+      "destination": "/realtime/react-hooks/overview"
+    },
+    {
+      "source": "/realtime/subscribe-to-run",
+      "destination": "/realtime/backend/subscribe"
+    },
+    {
+      "source": "/realtime/subscribe-to-runs-with-tag",
+      "destination": "/realtime/backend/subscribe"
+    },
+    {
+      "source": "/realtime/subscribe-to-batch",
+      "destination": "/realtime/backend/subscribe"
     },
     {
       "source": "/management/projects/runs",