fixup! Publish OpenAPI & swagger-ui to GH pages

Author: zehnm

core-api/rest/swagger-ui/favicon-16x16.png

@@ -8,6 +8,7 @@
     <script src="./swagger-ui-bundle.js" charset="UTF-8"> </script>
     <link rel="stylesheet" type="text/css" href="./swagger-ui.css" />
     <link rel="stylesheet" type="text/css" href="index.css" />
+    <link rel="icon" href="./favicon.ico" />
     <link rel="icon" type="image/png" href="./favicon-32x32.png" sizes="32x32" />
     <link rel="icon" type="image/png" href="./favicon-16x16.png" sizes="16x16" />
   </head>

core-api/rest/swagger-ui/favicon-32x32.png

@@ -27,15 +27,37 @@ interaction features are required, which are not present in the UCR Integration-
 The API specifications are defined with [OpenAPI](https://swagger.io/specification/) & [AsyncAPI](https://www.asyncapi.com/)
 in YAML format.
 
-- [REST Core-API](https://unfoldedcircle.github.io/core-api/rest/)
-- [WebSocket Core-API](https://unfoldedcircle.github.io/core-api/ws/)
+- [REST Core-API documentation viewer](https://unfoldedcircle.github.io/core-api/rest/)
+  - [REST Core-API YAML definition](https://github.com/unfoldedcircle/core-api/tree/main/core-api/rest)
+- [WebSocket Core-API documentation viewer](https://unfoldedcircle.github.io/core-api/ws/)
+  - [WebSocket Core-API YAML definition](https://github.com/unfoldedcircle/core-api/tree/main/core-api/websocket)
+
+## Dock API
+
+The Remote Two/3 WebSocket Dock-API allows you to directly interact with the Unfolded Circle smart charging docks and
+take full control of its features. 
+
+The API specification is defined with [AsyncAPI](https://www.asyncapi.com/) in YAML format.
+The WebSocket communication is using text messages with JSON payload.
+
+- [Dock AsyncAPI documentation viewer](https://unfoldedcircle.github.io/core-api/dock/)
+  - [Dock AsyncAPI YAML definition](https://github.com/unfoldedcircle/core-api/tree/main/dock-api)
+  - View with the [AsyncAPI Studio online tool](https://studio.asyncapi.com/?url=https://raw.githubusercontent.com/unfoldedcircle/core-api/main/dock-api/UCD2-asyncapi.yaml).  
+    The link will directly load the yaml definition file from GitHub and display it together with the HTML documentation
+    in the browser.
 
 ## Integration API
 
-- [Integration AsyncAPI definition](https://unfoldedcircle.github.io/core-api/integration/)
-- View with [AsyncAPI Studio online tool](https://studio.asyncapi.com/?url=https://raw.githubusercontent.com/unfoldedcircle/core-api/main/integration-api/UCR-integration-asyncapi.yaml).  
-  The link will directly load the yaml definition file from GitHub and display it together with the HTML documentation in
-  the browser.
+The Unfolded Circle WebSocket Integration-API allows writing device integration drivers for the Unfolded Circle Remotes.
+
+The API specification is defined with [AsyncAPI](https://www.asyncapi.com/) in YAML format.
+The WebSocket communication is using text messages with JSON payload.
+
+- [Integration AsyncAPI viewer](https://unfoldedcircle.github.io/core-api/integration/)
+  - [Integration AsyncAPI YAML definition](https://unfoldedcircle.github.io/core-api/integration/)
+  - View with [AsyncAPI Studio online tool](https://studio.asyncapi.com/?url=https://raw.githubusercontent.com/unfoldedcircle/core-api/main/integration-api/UCR-integration-asyncapi.yaml).  
+    The link will directly load the yaml definition file from GitHub and display it together with the HTML documentation
+    in the browser.
 
 ### Integration Driver