Add diagram

docs/dev/index.md

@@ -1,3 +1,32 @@
+---
+tags:
+ - developer
+ - api
+ - backend
+---
+
 # Developer & API Docs
 
-You can find the OpenAPI Documentation here: [api.OpenShock.app/swagger](https://api.openshock.app/swagger)
+
+## Backend Architecture
+
+![Backend Architecture Diagram](../../static/developer/backend-architecture-overview.svg)
+
+
+## OpenAPI Documentation
+
+You can find the OpenAPI Documentation here: [api.OpenShock.app/swagger](https://api.openshock.app/swagger)
+
+Note that there is both a [Definition Version 1](https://api.openshock.app/swagger/1/swagger.json) and [Definition Version 2](https://api.openshock.app/swagger/1/swagger.json) file.
+
+!!! hint "Version Definition Files"
+ You might notice that Version 2 does not contain all the endpoints that are in Version 1. That is because version 2 only contains endpoints that actually make a version 1 equivalent obsolete and there for deprecated. 
+ TL;DR; Prefer endpoints in Definition Version 2 over 1
+
+The OpenAPI documentation contains all HTTP endpoints, but does not document the WebSockets and SignalR hubs.
+
+## WebSockets
+
+There is a few different WebSocket endpoints. Most of them use json. The Hub (previously named Device) websocket uses flatbuffers binary serialization.
+
+- /1/