Restructure docs APIs (#504)

docs/external_api_rest_python.md

@@ -1,7 +0,0 @@
----
-title: "REST API - Python bindings"
----
-
-This API is deprecated and was removed since Home Assistant 0.77.0
-
-More information can be found in this [blog post](../../../blog/2018/08/13/deprecating-remote-package.html).

docusaurus.config.js

@@ -24,6 +24,19 @@ module.exports = {
         },
         { to: "docs/frontend_index", label: "Frontend", position: "left" },
         { to: "docs/development_index", label: "Backend", position: "left" },
+        {
+          label: "API",
+          position: "left",
+          items: [
+            { label: "REST-API", to: "docs/api/rest" },
+            { label: "WebSocket API", to: "docs/api/websocket" },
+            { label: "Server Sent Events", to: "docs/api/server-sent-events" },
+            {
+              label: "Native App Integration",
+              to: "docs/api/native-app-integration",
+            },
+          ],
+        },
         { to: "docs/misc", label: "Misc", position: "left" },
         { to: "blog", label: "Blog", position: "left" },
       ],

sidebars.js

@@ -6,6 +6,23 @@
  */
 
 module.exports = {
+  API: [
+    "api/rest",
+    "api/websocket",
+    "api/server-sent-events",
+    {
+      type: "category",
+      label: "Native App Integration",
+      items: [
+        "api/native-app-integration",
+        "api/native-app-integration/setup",
+        "api/native-app-integration/sending-data",
+        "api/native-app-integration/sensors",
+        "api/native-app-integration/notifications",
+        "api/native-app-integration/webview",
+      ],
+    },
+  ],
   Architecture: {
     Architecture: [
       "architecture_index",
@@ -105,12 +122,6 @@ module.exports = {
   },
   Misc: {
     Introduction: ["misc"],
-    "External API": [
-      "external_api_rest",
-      "external_api_rest_python",
-      "external_api_websocket",
-      "external_api_server_sent_events",
-    ],
     Internationalization: [
       "internationalization_index",
       "internationalization_backend_localization",
@@ -129,14 +140,6 @@ module.exports = {
       "intent_conversation",
       "intent_builtin",
     ],
-    "Native App Integration": [
-      "app_integration_index",
-      "app_integration_setup",
-      "app_integration_sending_data",
-      "app_integration_sensors",
-      "app_integration_notifications",
-      "app_integration_webview",
-    ],
     "Building a Python library": [
       "api_lib_index",
       "api_lib_auth",

static/_redirects

@@ -0,0 +1,13 @@
+# These redirects are handled by Netlify
+#
+
+# Documentation restructuring redirects
+/docs/app_integration_index /docs/api/native-app-integration
+/docs/app_integration_notifications /docs/api/native-app-integration/notifications
+/docs/app_integration_sending_data /docs/api/native-app-integration/sending-data
+/docs/app_integration_sensors /docs/api/native-app-integration/sensors
+/docs/app_integration_setup /docs/api/native-app-integration/setup
+/docs/app_integration_webview /docs/api/native-app-integration/webview
+/docs/external_api_rest /docs/api/rest
+/docs/external_api_server_sent_events /docs/api/server-sent-events
+/docs/external_api_websocket /docs/api/websocket