diff --git a/docs/app_integration_index.md b/docs/api/native-app-integration.md similarity index 100% rename from docs/app_integration_index.md rename to docs/api/native-app-integration.md diff --git a/docs/app_integration_notifications.md b/docs/api/native-app-integration/notifications.md similarity index 100% rename from docs/app_integration_notifications.md rename to docs/api/native-app-integration/notifications.md diff --git a/docs/app_integration_sending_data.md b/docs/api/native-app-integration/sending-data.md similarity index 100% rename from docs/app_integration_sending_data.md rename to docs/api/native-app-integration/sending-data.md diff --git a/docs/app_integration_sensors.md b/docs/api/native-app-integration/sensors.md similarity index 100% rename from docs/app_integration_sensors.md rename to docs/api/native-app-integration/sensors.md diff --git a/docs/app_integration_setup.md b/docs/api/native-app-integration/setup.md similarity index 100% rename from docs/app_integration_setup.md rename to docs/api/native-app-integration/setup.md diff --git a/docs/app_integration_webview.md b/docs/api/native-app-integration/webview.md similarity index 100% rename from docs/app_integration_webview.md rename to docs/api/native-app-integration/webview.md diff --git a/docs/external_api_rest.md b/docs/api/rest.md similarity index 100% rename from docs/external_api_rest.md rename to docs/api/rest.md diff --git a/docs/external_api_server_sent_events.md b/docs/api/server-sent-events.md similarity index 100% rename from docs/external_api_server_sent_events.md rename to docs/api/server-sent-events.md diff --git a/docs/external_api_websocket.md b/docs/api/websocket.md similarity index 100% rename from docs/external_api_websocket.md rename to docs/api/websocket.md diff --git a/docs/external_api_rest_python.md b/docs/external_api_rest_python.md deleted file mode 100644 index efb71059..00000000 --- a/docs/external_api_rest_python.md +++ /dev/null @@ -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). diff --git a/docusaurus.config.js b/docusaurus.config.js index 7b983361..55d60146 100644 --- a/docusaurus.config.js +++ b/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" }, ], diff --git a/sidebars.js b/sidebars.js index 5ef0d99f..4530ce33 100644 --- a/sidebars.js +++ b/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", diff --git a/static/_redirects b/static/_redirects new file mode 100644 index 00000000..d7eefffc --- /dev/null +++ b/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