openremote · wborn · Jun 1, 2026 · Oct 29, 2025 · Nov 26, 2025 · Jan 14, 2026
diff --git a/docs/developer-guide/adding-widgets-on-insights.md b/docs/developer-guide/adding-widgets-on-insights.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 10
+sidebar_position: 35
 ---
 
 # Adding Widgets on Insights

diff --git a/docs/developer-guide/agent-protocol-spi.md b/docs/developer-guide/agent-protocol-spi.md
@@ -0,0 +1,16 @@
+---
+sidebar_position: 13
+---
+
+# Agent and protocol SPI
+
+See the `HTTPProtocol.java` as an example as this will give you a good guide of what to do to build protocol:
+
+`agent/src/main/java/org/openremote/agent/protocol/http/HTTPProtocol.java`
+
+Here’s some helpful info:
+
+- Protocols are one instance per Agent; you’ll see that each Protocol has a corresponding Agent class see here for example.
+- Each Asset type has a concrete class and Agents are a sub type of Asset so they therefore have their own classes also (this gives us better type safety)
+- An Agent's configuration is stored in individual attributes; these attributes are defined in the Agent class.
+- agentLink MetaItem now contains all the configuration needed to connect an attribute to a specific Agent
diff --git a/docs/developer-guide/building-and-testing.md b/docs/developer-guide/building-and-testing.md
diff --git a/docs/developer-guide/connecting-protocol-adaptors-with-agents.md b/docs/developer-guide/connecting-protocol-adaptors-with-agents.md
diff --git a/docs/developer-guide/creating-a-custom-project.md b/docs/developer-guide/creating-a-custom-project.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 8
+sidebar_position: 12
 ---
 
 # Creating a custom project

diff --git a/docs/developer-guide/data-migration.md b/docs/developer-guide/data-migration.md
diff --git a/docs/developer-guide/docker-compose-profiles.md b/docs/developer-guide/docker-compose-profiles.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 7
+sidebar_position: 11
 ---
 
 # Docker Compose profiles

diff --git a/docs/developer-guide/gateway-tunnelling-setup.md b/docs/developer-guide/gateway-tunnelling-setup.md
@@ -17,7 +17,7 @@ This guide describes the steps necessary to setup the gateway tunnelling functio
 * `ssh-keygen -t ed25519 -b 4096 -f server_key`
 * `mv server_key deployment/sish/keys`
 
-### Docker envrionment variables
+### Docker environment variables
 
 * Set Keycloak container environment variables:
   * `KEYCLOAK_ISSUER_BASE_URI: https://${OR_HOSTNAME}/auth`

diff --git a/docs/developer-guide/installing-and-using-docker.md b/docs/developer-guide/installing-and-using-docker.md
diff --git a/docs/developer-guide/licensing-guidelines-for-contributors.md b/docs/developer-guide/licensing-guidelines-for-contributors.md
@@ -13,7 +13,7 @@ Tip: use `./gradlew dependencies` on projects that use gradle as build tool.
 In all source files (except where not appropriate such as property files or test fixtures), include a copyright header:
 
 ```
-Copyright 2021, OpenRemote Inc.
+Copyright ${YEAR}, OpenRemote Inc.
 
 See the CONTRIBUTORS.txt file in the distribution for a
 full listing of individual contributors.