updated project site -- build no: 26 -- one more try
diff --git a/1.0/feed.xml b/1.0/feed.xml
deleted file mode 100644
index 47c4162..0000000
--- a/1.0/feed.xml
+++ /dev/null
@@ -1,815 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
-    <channel>
-        <title>Eclipse Ditto Blog</title>
-        <description>Announcements, tutorials and examples around Eclipse Ditto and Digital Twins</description>
-        <link>https://www.eclipse.org/ditto/</link>
-        <atom:link href="https://www.eclipse.org/ditto/feed.xml" rel="self" type="application/rss+xml"/>
-        <pubDate>Wed, 29 Apr 2020 09:05:19 +0000</pubDate>
-        <lastBuildDate>Wed, 29 Apr 2020 09:05:19 +0000</lastBuildDate>
-        <generator>Jekyll v3.6.2</generator>
-        
-        <item>
-            <title>Announcing Eclipse Ditto Release 1.0.0</title>
-            <description>&lt;p&gt;Today the Eclipse Ditto is thrilled to announce the availability of Eclipse Ditto’s first major release
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0&quot;&gt;1.0.0&lt;/a&gt;.&lt;/p&gt;
-
-&lt;h2 id=&quot;maturity&quot;&gt;Maturity&lt;/h2&gt;
-
-&lt;p&gt;The initial code contribution was done in October 2017, 2 years later and 2 releases 
-(&lt;a href=&quot;2018-11-28-release-announcement-080.html&quot;&gt;0.8.0&lt;/a&gt; and &lt;a href=&quot;2019-07-10-release-announcement-090.html&quot;&gt;0.9.0&lt;/a&gt;) later, we 
-think its time to graduate from the Eclipse “incubation” phase and officially declare the project as mature.&lt;/p&gt;
-
-&lt;p&gt;Recent adoptions and contributions from our community show us that Eclipse Ditto solves problems which also other
-companies have. Adopters add Eclipse Ditto as a central part of their own IoT platforms.&lt;/p&gt;
-
-&lt;h3 id=&quot;api-stability&quot;&gt;API stability&lt;/h3&gt;
-
-&lt;p&gt;Having reached 1.0.0, some additional promises towards “API stability” do apply:&lt;/p&gt;
-
-&lt;h4 id=&quot;http-api-stability&quot;&gt;HTTP API stability&lt;/h4&gt;
-&lt;p&gt;Ditto uses schema versioning (currently schema version 1 and 2) at the HTTP API level in order to being able to 
-evolve APIs.
-It is backward compatible to the prior versions 0.8.0 and 0.9.0.&lt;/p&gt;
-
-&lt;h4 id=&quot;json-api-stability&quot;&gt;JSON API stability&lt;/h4&gt;
-&lt;p&gt;Ditto kept its main JSON APIs (regarding things, policies and search) backwards compatible to 0.8.0 and 0.9.0 releases.
-The JSON format of “connections” was changed since 0.9.0 and will from 1.0.0 on be kept backwards compatible as well.&lt;/p&gt;
-
-&lt;h4 id=&quot;java-api-stability&quot;&gt;Java API stability&lt;/h4&gt;
-&lt;p&gt;The Java APIs will for the 1.x release be kept backwards compatible, so only non-breaking additions to the APIs will be done. This is enforced by a Maven tooling.&lt;/p&gt;
-
-&lt;p&gt;The following Java modules are treated as API for which compatibility is enforced:&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;ditto-json&lt;/li&gt;
-  &lt;li&gt;ditto-model-*&lt;/li&gt;
-  &lt;li&gt;ditto-signals-*&lt;/li&gt;
-  &lt;li&gt;ditto-protocol-adapter&lt;/li&gt;
-  &lt;li&gt;ditto-utils&lt;/li&gt;
-  &lt;li&gt;ditto-client&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h3 id=&quot;scalability&quot;&gt;Scalability&lt;/h3&gt;
-
-&lt;p&gt;The focus on the 0.9.0 and 1.0.0 releases regarding non-functionals were laid on horizontal scalability.&lt;/p&gt;
-
-&lt;p&gt;With Eclipse Ditto 1.0.0 we are confident to face production grade scalability requirements being capable of handling 
-millions of managed things.&lt;/p&gt;
-
-&lt;h2 id=&quot;changelog&quot;&gt;Changelog&lt;/h2&gt;
-
-&lt;p&gt;The main changes compared to the last release, &lt;a href=&quot;release_notes_090.html&quot;&gt;0.9.0&lt;/a&gt;, are:&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;addition of a Java and a JavaScript client SDK in separate &lt;a href=&quot;https://github.com/eclipse/ditto-clients&quot;&gt;GitHub repo&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;configurable OpenID Connect authorization servers&lt;/li&gt;
-  &lt;li&gt;support for OpenID Connect / OAuth2.0 based authentication in Ditto Java Client&lt;/li&gt;
-  &lt;li&gt;invoking custom foreign HTTP endpoints as a result of events/messages&lt;/li&gt;
-  &lt;li&gt;ability to reflect Eclipse Hono’s device connection state in Ditto’s things&lt;/li&gt;
-  &lt;li&gt;configurable throttling of max. consumed WebSocket commands / time interval&lt;/li&gt;
-  &lt;li&gt;Addition of “definition” field in thing at model level containing the model ID a thing may follow&lt;/li&gt;
-  &lt;li&gt;Improved connection response handling/mapping&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Please have a look at the &lt;a href=&quot;release_notes_100.html&quot;&gt;1.0.0 release notes&lt;/a&gt; for a more detailed information on the release.&lt;/p&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Thu, 12 Dec 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-12-12-release-announcement-100.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-12-12-release-announcement-100.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Ditto Milestone 1.0.0-M2</title>
-            <description>&lt;p&gt;The second and last milestone of the upcoming release 
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0&quot;&gt;1.0.0&lt;/a&gt; was released today.&lt;/p&gt;
-
-&lt;p&gt;Have a look at the Milestone &lt;a href=&quot;release_notes_100-M2.html&quot;&gt;1.0.0-M2 release notes&lt;/a&gt; for what changed in detail.&lt;/p&gt;
-
-&lt;p&gt;The main changes and new features since the last release &lt;a href=&quot;release_notes_100-M1a.html&quot;&gt;1.0.0-M1a release notes&lt;/a&gt; are&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;invoking custom foreign HTTP endpoints as a result of events/messages&lt;/li&gt;
-  &lt;li&gt;ability to reflect Eclipse Hono’s device connection state in Ditto’s things&lt;/li&gt;
-  &lt;li&gt;support for OpenID Connect / OAuth2.0 based authentication in Ditto Java Client&lt;/li&gt;
-  &lt;li&gt;configurbale throttling of max. consumed WebSocket commands / time interval&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Mon, 04 Nov 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-11-04-milestone-announcement-100-M2.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-11-04-milestone-announcement-100-M2.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Integration of HTTP endpoints/webhooks</title>
-            <description>&lt;p&gt;By adding another connectivity type - &lt;a href=&quot;connectivity-protocol-bindings-http.html&quot;&gt;HTTP&lt;/a&gt; - to Ditto’s 
- connectivity, it is now (to be released in the next Ditto milestone 1.0.0-M2) possible to to 
- publish &lt;em&gt;twin events&lt;/em&gt;, &lt;em&gt;messages&lt;/em&gt;, &lt;em&gt;live commands and events&lt;/em&gt; to existing HTTP servers/endpoints.&lt;/p&gt;
-
-&lt;p&gt;That is especially useful for invoking existing APIs (which are most of the time HTTP based) whenever e.g.
- a digital twin was modified.&lt;/p&gt;
-
-&lt;p&gt;One example on how to benefit from this new feature is to invoke a custom 
- &lt;a href=&quot;https://ifttt.com&quot;&gt;IFTTT&lt;/a&gt; (if-this-than-that) &lt;a href=&quot;https://ifttt.com/maker_webhooks&quot;&gt;webhook&lt;/a&gt; via a HTTP &lt;code class=&quot;highlighter-rouge&quot;&gt;POST&lt;/code&gt; request
- which then may trigger other IFTTT follow-up-actions (e.g. send a chat message to a &lt;a href=&quot;https://ifttt.com/slack&quot;&gt;Slack&lt;/a&gt; 
- room).&lt;/p&gt;
-
-&lt;p&gt;For IFTTT “webhooks” the address would be &lt;code class=&quot;highlighter-rouge&quot;&gt;POST https://maker.ifttt.com/trigger/&amp;lt;your-event-name&amp;gt;/with/key/&amp;lt;your-key&amp;gt;&lt;/code&gt; 
- and the expected JSON body:&lt;/p&gt;
-
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value1&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;...&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value2&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;...&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value3&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;...&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;In combination with &lt;a href=&quot;connectivity-mapping.html&quot;&gt;payload mapping&lt;/a&gt;, the &lt;code class=&quot;highlighter-rouge&quot;&gt;value1&lt;/code&gt; to &lt;code class=&quot;highlighter-rouge&quot;&gt;value3&lt;/code&gt; fields requested by the IFTTT
-API can be extracted from the &lt;a href=&quot;protocol-specification.html&quot;&gt;Ditto Protocol&lt;/a&gt; and could contain the changed value.&lt;/p&gt;
-
-&lt;p&gt;In combination with &lt;a href=&quot;basic-connections.html#target-topics-and-filtering&quot;&gt;filters for targets&lt;/a&gt; you can even specify to
-only publish e.g. &lt;code class=&quot;highlighter-rouge&quot;&gt;twin events&lt;/code&gt;, where the temperature of a twin exceeded a certain threshold:&lt;/p&gt;
-
-&lt;div class=&quot;highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;{
-  &quot;address&quot;: &quot;POST:/trigger/&amp;lt;your-event-name&amp;gt;/with/key/&amp;lt;your-key&amp;gt;&quot;,
-  &quot;topics&quot;: [
-    &quot;_/_/things/twin/events?filter=gt(features/temperature/value,25)&quot;
-  ],
-  ...
-}
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Get creative on which HTTP APIs to trigger based on twin events. E.g. invoke a “function-as-a-service” API or invoke the 
-Twitter API and let your digital twin tweet whenever it detects, that it is getting too warm in your office.&lt;/p&gt;
-
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Thu, 17 Oct 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-10-17-http-connectivity.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-10-17-http-connectivity.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Ditto Milestone 1.0.0-M1a</title>
-            <description>&lt;p&gt;Today the Ditto team is happy to announce the first milestone of the upcoming release 
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0&quot;&gt;1.0.0&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;Have a look at the Milestone &lt;a href=&quot;release_notes_100-M1a.html&quot;&gt;1.0.0-M1a release notes&lt;/a&gt; for what changed in detail.&lt;/p&gt;
-
-&lt;p&gt;The main changes and new features since the last release &lt;a href=&quot;release_notes_090.html&quot;&gt;0.9.0&lt;/a&gt; are&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;initial contribution of Java client SDK&lt;/li&gt;
-  &lt;li&gt;configurable OpenID Connect authorization servers&lt;/li&gt;
-  &lt;li&gt;fine grained access for connections&lt;/li&gt;
-  &lt;li&gt;scalable event publishing&lt;/li&gt;
-  &lt;li&gt;typed entity IDs&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Tue, 17 Sep 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-09-17-milestone-announcement-100-M1a.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-09-17-milestone-announcement-100-M1a.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Eclipse Ditto now supports OpenID Connect</title>
-            <description>&lt;p&gt;Eclipse Ditto now supports all OAuth 2.0 providers which implement &lt;a href=&quot;https://openid.net/connect/&quot;&gt;OpenID Connect&lt;/a&gt; out-of-the-box.
-You can find a list of certified providers at &lt;a href=&quot;https://openid.net/developers/certified/&quot;&gt;OpenID Connect - Certified OpenID Provider Servers and Services&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;With this post, we want to give an example of this new feature using the open source provider &lt;a href=&quot;https://www.ory.sh&quot;&gt;ORY Hydra&lt;/a&gt;.
-Follow their &lt;a href=&quot;https://www.ory.sh/docs/next/hydra/configure-deploy#installing-ory-hydra&quot;&gt;installation guide&lt;/a&gt; for a
- docker based setup on your development machine.&lt;/p&gt;
-
-&lt;h4 id=&quot;configuration&quot;&gt;Configuration&lt;/h4&gt;
-&lt;p&gt;Download the self-signed certificate form the ORY Hydra server: https://localhost:9000/.well-known/openid-configuration&lt;/p&gt;
-
-&lt;p&gt;Use the downloaded certificate for the akka-http ssl configuration.&lt;/p&gt;
-&lt;pre&gt;&lt;code class=&quot;language-hocon&quot;&gt;ssl-config {
-  trustManager = {
-    stores = [
-      { type = &quot;PEM&quot;, path = &quot;/path/to/cert/globalsign.crt&quot; }
-    ]
-  }
-}
-&lt;/code&gt;&lt;/pre&gt;
-
-&lt;p&gt;The authentication provider must be added to the ditto-gateway configuration.&lt;/p&gt;
-&lt;pre&gt;&lt;code class=&quot;language-hocon&quot;&gt;ditto.gateway.authentication {
-    oauth {
-      openid-connect-issuers = {
-        ory = &quot;https://localhost:9000/&quot;
-      }
-    }
-}
-&lt;/code&gt;&lt;/pre&gt;
-
-&lt;p&gt;The configured subject-issuer will be used to prefix the value of the “sub” claim, e.g.&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;subjects&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;ory:foo@bar.com&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;type&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;generated&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h4 id=&quot;authenticate-ditto-api&quot;&gt;Authenticate Ditto API&lt;/h4&gt;
-&lt;p&gt;Create an OAuth client with hydra to be able to create ID Tokens.&lt;/p&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;docker run &lt;span class=&quot;nt&quot;&gt;--rm&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-it&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;-e&lt;/span&gt; &lt;span class=&quot;nv&quot;&gt;HYDRA_ADMIN_URL&lt;/span&gt;&lt;span class=&quot;o&quot;&gt;=&lt;/span&gt;https://ory-hydra-example--hydra:4445 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;--network&lt;/span&gt; hydraguide &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  oryd/hydra:v1.0.0 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  clients create &lt;span class=&quot;nt&quot;&gt;--skip-tls-verify&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--id&lt;/span&gt; eclipse-ditto &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--secret&lt;/span&gt; some-secret &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--grant-types&lt;/span&gt; authorization_code,refresh_token,client_credentials,implicit &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--response-types&lt;/span&gt; token,code,id_token &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--scope&lt;/span&gt; openid,offline &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--callbacks&lt;/span&gt; http://127.0.0.1:9010/callback
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Use the client to generate an ID Token.&lt;/p&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;docker run &lt;span class=&quot;nt&quot;&gt;--rm&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-it&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;--network&lt;/span&gt; hydraguide &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;-p&lt;/span&gt; 9010:9010 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  oryd/hydra:v1.0.0 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  token user &lt;span class=&quot;nt&quot;&gt;--skip-tls-verify&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--port&lt;/span&gt; 9010 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--auth-url&lt;/span&gt; https://localhost:9000/oauth2/auth &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--token-url&lt;/span&gt; https://ory-hydra-example--hydra:4444/oauth2/token &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--client-id&lt;/span&gt; eclipse-ditto &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--client-secret&lt;/span&gt; some-secret &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--scope&lt;/span&gt; openid
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-&lt;p&gt;After that perform the OAuth 2.0 Authorize Code Flow by opening the link, as prompted, 
-in your browser, and follow the steps shown there.&lt;/p&gt;
-
-&lt;p&gt;Use the generated token to authenticate Ditto API.&lt;/p&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; POST &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  http://localhost:8080/api/2/things &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Authorization: Bearer &amp;lt;JWT&amp;gt;'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{}'&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Wed, 28 Aug 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-08-28-openid-connect.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-08-28-openid-connect.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Eclipse Ditto Release 0.9.0</title>
-            <description>&lt;p&gt;Today the Eclipse Ditto team proudly presents its second release 
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/0.9.0&quot;&gt;0.9.0&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The topics of this release in a nutshell were:&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;Memory improvements for huge amounts (multi million) of digital twins which are held in memory&lt;/li&gt;
-  &lt;li&gt;Adding metrics and logging around the connectivity feature in order to enable being able to operate connections to foreign systems/brokers via APIs&lt;/li&gt;
-  &lt;li&gt;Enhancing Ditto’s connectivity feature by additionally being able to connect to Apache Kafka&lt;/li&gt;
-  &lt;li&gt;Performance improvements of Ditto’s search functionality&lt;/li&gt;
-  &lt;li&gt;Stabilization of cluster bootstrapping&lt;/li&gt;
-  &lt;li&gt;Refactoring of how the services configurations are determined&lt;/li&gt;
-  &lt;li&gt;Addition of a Helm template in order to simplify Kubernetes based deployments&lt;/li&gt;
-  &lt;li&gt;Contributions from Microsoft in order to ease operating Eclipse Ditto on Microsoft Azure&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Please have a look at the &lt;a href=&quot;release_notes_090.html&quot;&gt;0.9.0 release notes&lt;/a&gt; for a more detailed information on the release.&lt;/p&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Wed, 10 Jul 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-07-10-release-announcement-090.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-07-10-release-announcement-090.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Ditto Milestone 0.9.0-M2</title>
-            <description>&lt;p&gt;The second milestone of the upcoming release 
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/0.9.0&quot;&gt;0.9.0&lt;/a&gt; was released today.&lt;/p&gt;
-
-&lt;p&gt;Have a look at the Milestone &lt;a href=&quot;release_notes_090-M2.html&quot;&gt;0.9.0-M2 release notes&lt;/a&gt; for what changed in detail.&lt;/p&gt;
-
-&lt;p&gt;The main changes and new features since the last milestone &lt;a href=&quot;release_notes_090-M1.html&quot;&gt;0.9.0-M1&lt;/a&gt; are&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;rewrite of Ditto’s “search” service in order to use the same index and have the same query performance for API v1 and v2&lt;/li&gt;
-  &lt;li&gt;several contributions in order to operate Eclipse Ditto on Microsoft Azure&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Mon, 29 Apr 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-04-29-milestone-announcement-090-M2.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-04-29-milestone-announcement-090-M2.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Ditto Milestone 0.9.0-M1</title>
-            <description>&lt;p&gt;Today the Ditto team is happy to announce the first milestone of the upcoming release 
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/0.9.0&quot;&gt;0.9.0&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;Have a look at the Milestone &lt;a href=&quot;release_notes_090-M1.html&quot;&gt;0.9.0-M1 release notes&lt;/a&gt; for what changed in detail.&lt;/p&gt;
-
-&lt;p&gt;The main changes and new features since the last release &lt;a href=&quot;release_notes_080.html&quot;&gt;0.8.0&lt;/a&gt; are&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;memory optimizations when working with millions of digital twins&lt;/li&gt;
-  &lt;li&gt;enhance connectivity to also be able to establish connections to Apache Kafka&lt;/li&gt;
-  &lt;li&gt;providing more detailed metrics for connections&lt;/li&gt;
-  &lt;li&gt;cluster bootstrapping stability improvements&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Thu, 28 Mar 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-03-28-milestone-announcement-090-M1.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-03-28-milestone-announcement-090-M1.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Connectivity to Apache Kafka in Eclipse Ditto</title>
-            <description>&lt;p&gt;Today we added connectivity to &lt;a href=&quot;https://kafka.apache.org/&quot;&gt;Apache Kafka&lt;/a&gt;. In a first step, it is possible to publish
-&lt;em&gt;twin events&lt;/em&gt;, &lt;em&gt;messages&lt;/em&gt;, &lt;em&gt;live commands and events&lt;/em&gt; to Kafka topics.&lt;/p&gt;
-
-&lt;p&gt;Since the last addition to Ditto’s connectivity which &lt;a href=&quot;2018-10-16-example-mqtt-bidirectional.html&quot;&gt;added MQTT connectivity&lt;/a&gt;,
-the connectivity feature got a lot of stabilization and new smaller features, e.g. the recent addition of 
-&lt;a href=&quot;basic-placeholders.html#function-expressions&quot;&gt;placeholder functions&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;Returning to the Kafka integration Ditto can now, for example, whenever a &lt;a href=&quot;intro-digitaltwins.html&quot;&gt;digital twin&lt;/a&gt; is 
-changed (e.g. a device updated some state data), publish a &lt;em&gt;twin event&lt;/em&gt; to a Kafka topic.&lt;/p&gt;
-
-&lt;p&gt;If you already rely on Apache Kafka as a source for your data lake or analytics, integrating Ditto and its digital twins
-is now super easy.&lt;/p&gt;
-
-&lt;p&gt;Find out more at our &lt;a href=&quot;connectivity-protocol-bindings-kafka2.html&quot;&gt;Kafka documentation&lt;/a&gt;.&lt;/p&gt;
-
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Wed, 13 Mar 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-03-13-kafka-connectivity.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-03-13-kafka-connectivity.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Using Eclipse Hono's Command&amp;Control with Eclipse Ditto</title>
-            <description>&lt;p&gt;With &lt;a href=&quot;release_notes_080.html&quot;&gt;version 0.8.0&lt;/a&gt; Eclipse Ditto can now interact with Eclipse Hono using the 
-“Command &amp;amp; Control” feature. It is possible to send a 
-Thing (or Feature) message at the Ditto Message API, which is then forwarded to Hono as a 
-command message. Hono routes the message to the device, which in turn can send a response to the command including a 
-status, telling if the command was successfully processed or not. 
-This response is routed back via Hono to the Ditto Message API.&lt;/p&gt;
-
-&lt;p&gt;In this example we connect the &lt;a href=&quot;https://ditto.eclipse.org/&quot;&gt;Ditto sandbox&lt;/a&gt; and the 
-&lt;a href=&quot;https://www.eclipse.org/hono/sandbox/&quot;&gt;Hono sandbox&lt;/a&gt; to send a message (3) to a simulated device via the 
-Ditto Messages API. The device receives the command from the Hono HTTP Adapter and responds with a message (4) 
-that is routed back to the caller at the Ditto Message API (5). For the sake of simplicity we use simple curl 
-commands both for the Ditto and Hono HTTP APIs.&lt;/p&gt;
-
-&lt;p&gt;The following steps are covered in this example:&lt;/p&gt;
-
-&lt;ol&gt;
-  &lt;li&gt;Setup a connection between Eclipse Ditto and Hono sandboxes&lt;/li&gt;
-  &lt;li&gt;Signal availability of the device&lt;/li&gt;
-  &lt;li&gt;Send a Ditto message&lt;/li&gt;
-  &lt;li&gt;Device receives command and sends command response&lt;/li&gt;
-  &lt;li&gt;Caller receives response at Ditto Message API&lt;/li&gt;
-&lt;/ol&gt;
-
-&lt;p&gt;&lt;img src=&quot;images/blog/2018-12-14-command-and-control.png&quot; alt=&quot;Command and Control&quot; /&gt;&lt;/p&gt;
-
-&lt;h3 id=&quot;prerequisites-a-ditto-digital-twin-and-a-hono-device&quot;&gt;Prerequisites: A Ditto digital twin and a Hono device&lt;/h3&gt;
-
-&lt;p&gt;The creation of a Hono device and Ditto digital twin has already been covered in the blog post 
-&lt;a href=&quot;2018-05-02-connecting-ditto-hono.html&quot;&gt;Connecting Eclipse Ditto to Eclipse Hono&lt;/a&gt;. For brevity we will just list the 
-required commands to create a twin/device here. For a detailed explanation of the steps please refer to the previous 
-post.&lt;/p&gt;
-
-&lt;h4 id=&quot;create-hono-device&quot;&gt;Create Hono device&lt;/h4&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;c&quot;&gt;# setup a tenant&lt;/span&gt;
-&lt;span class=&quot;nv&quot;&gt;$ &lt;/span&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; POST &lt;span class=&quot;nt&quot;&gt;-i&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{&quot;tenant-id&quot;: &quot;org.eclipse.ditto&quot;}'&lt;/span&gt; http://hono.eclipse.org:28080/tenant
-&lt;span class=&quot;c&quot;&gt;# create a device&lt;/span&gt;
-&lt;span class=&quot;nv&quot;&gt;$ &lt;/span&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; POST &lt;span class=&quot;nt&quot;&gt;-i&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{&quot;device-id&quot;: &quot;org.eclipse.ditto:teapot&quot;}'&lt;/span&gt; http://hono.eclipse.org:28080/registration/org.eclipse.ditto
-&lt;span class=&quot;c&quot;&gt;# add device credentials&lt;/span&gt;
-&lt;span class=&quot;nv&quot;&gt;$ PWD_HASH&lt;/span&gt;&lt;span class=&quot;o&quot;&gt;=&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;$(&lt;/span&gt;&lt;span class=&quot;nb&quot;&gt;echo&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-n&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'teapot'&lt;/span&gt; | openssl dgst &lt;span class=&quot;nt&quot;&gt;-binary&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-sha512&lt;/span&gt; | base64 &lt;span class=&quot;nt&quot;&gt;-w&lt;/span&gt; 0&lt;span class=&quot;k&quot;&gt;)&lt;/span&gt;
-&lt;span class=&quot;nv&quot;&gt;$ &lt;/span&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; POST &lt;span class=&quot;nt&quot;&gt;-i&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{
-  &quot;device-id&quot;: &quot;org.eclipse.ditto:teapot&quot;,
-  &quot;type&quot;: &quot;hashed-password&quot;,
-  &quot;auth-id&quot;: &quot;teapot&quot;,
-  &quot;secrets&quot;: [{
-      &quot;hash-function&quot; : &quot;sha-512&quot;,
-      &quot;pwd-hash&quot;: &quot;'&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;$PWD_HASH&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'&quot;
-  }]
-}'&lt;/span&gt; http://hono.eclipse.org:28080/credentials/org.eclipse.ditto
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h4 id=&quot;create-ditto-policy-for-digital-twin&quot;&gt;Create Ditto policy for digital twin&lt;/h4&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;c&quot;&gt;# create policy in Ditto&lt;/span&gt;
-&lt;span class=&quot;nv&quot;&gt;$ &lt;/span&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; PUT &lt;span class=&quot;nt&quot;&gt;-i&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; demo5:demo &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{
-   &quot;policyId&quot;: &quot;org.eclipse.ditto:teapot-policy&quot;,
-   &quot;entries&quot;: {
-       &quot;DEMO&quot;: {
-           &quot;subjects&quot;: {
-              &quot;nginx:demo5&quot;: {
-                  &quot;type&quot;: &quot;basic auth user and user used in connection'&lt;/span&gt;s authorizationContext&lt;span class=&quot;s2&quot;&gt;&quot;
-              }
-           },
-           &quot;&lt;/span&gt;resources&lt;span class=&quot;s2&quot;&gt;&quot;: {
-               &quot;&lt;/span&gt;thing:/&lt;span class=&quot;s2&quot;&gt;&quot;: {
-                   &quot;&lt;/span&gt;grant&lt;span class=&quot;s2&quot;&gt;&quot;: [&quot;&lt;/span&gt;READ&lt;span class=&quot;s2&quot;&gt;&quot;, &quot;&lt;/span&gt;WRITE&lt;span class=&quot;s2&quot;&gt;&quot;],
-                   &quot;&lt;/span&gt;revoke&lt;span class=&quot;s2&quot;&gt;&quot;: []
-               },
-               &quot;&lt;/span&gt;policy:/&lt;span class=&quot;s2&quot;&gt;&quot;: {
-                   &quot;&lt;/span&gt;grant&lt;span class=&quot;s2&quot;&gt;&quot;: [&quot;&lt;/span&gt;READ&lt;span class=&quot;s2&quot;&gt;&quot;, &quot;&lt;/span&gt;WRITE&lt;span class=&quot;s2&quot;&gt;&quot;],
-                   &quot;&lt;/span&gt;revoke&lt;span class=&quot;s2&quot;&gt;&quot;: []
-               },
-               &quot;&lt;/span&gt;message:/&lt;span class=&quot;s2&quot;&gt;&quot;: {
-                   &quot;&lt;/span&gt;grant&lt;span class=&quot;s2&quot;&gt;&quot;: [&quot;&lt;/span&gt;READ&lt;span class=&quot;s2&quot;&gt;&quot;, &quot;&lt;/span&gt;WRITE&lt;span class=&quot;s2&quot;&gt;&quot;],
-                   &quot;&lt;/span&gt;revoke&lt;span class=&quot;s2&quot;&gt;&quot;: []
-               }
-           }
-       }
-   }
-}' https://ditto.eclipse.org/api/2/policies/org.eclipse.ditto:teapot-policy 
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h4 id=&quot;create-ditto-digital-twin&quot;&gt;Create Ditto digital twin&lt;/h4&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;c&quot;&gt;# create thing in Ditto&lt;/span&gt;
-&lt;span class=&quot;nv&quot;&gt;$ &lt;/span&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; PUT &lt;span class=&quot;nt&quot;&gt;-i&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; demo5:demo &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{
-    &quot;policyId&quot;: &quot;org.eclipse.ditto:teapot-policy&quot;,
-    &quot;features&quot;: {
-      &quot;water&quot;: {
-        &quot;properties&quot;: {
-          &quot;temperature&quot;: 20
-        }
-      }
-    }
-}'&lt;/span&gt; https://ditto.eclipse.org/api/2/things/org.eclipse.ditto:teapot 
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h3 id=&quot;setup-a-connection-for-command--control&quot;&gt;Setup a connection for Command &amp;amp; Control&lt;/h3&gt;
-&lt;p&gt;In order to forward Ditto Messages to the device as a Hono command we first need to setup and configure a 
-&lt;a href=&quot;connectivity-manage-connections.html&quot;&gt;connection&lt;/a&gt; between Eclipse Ditto and Eclipse Hono that is prepared for 
-&lt;em&gt;Command &amp;amp; Control&lt;/em&gt; messages. According to the 
-&lt;a href=&quot;https://www.eclipse.org/hono/&quot;&gt;Hono documentation&lt;/a&gt; 
-the connection must contain a target with the address &lt;code class=&quot;highlighter-rouge&quot;&gt;control/&amp;lt;tenant-id&amp;gt;/&amp;lt;device-id&amp;gt;&lt;/code&gt; 
-and a source with the address &lt;code class=&quot;highlighter-rouge&quot;&gt;control/&amp;lt;tenant-id&amp;gt;/&amp;lt;reply-identifier&amp;gt;&lt;/code&gt;. The &lt;code class=&quot;highlighter-rouge&quot;&gt;reply-identifier&lt;/code&gt; can be 
-chosen arbitrarily, but must be set as the &lt;code class=&quot;highlighter-rouge&quot;&gt;reply-to&lt;/code&gt; header of a command exactly as defined in the connection:&lt;/p&gt;
-
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; POST &lt;span class=&quot;nt&quot;&gt;-i&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; devops:devopsPw1! &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{
-           &quot;targetActorSelection&quot;: &quot;/system/sharding/connection&quot;,
-           &quot;headers&quot;: {
-             &quot;aggregate&quot;: false
-           },
-           &quot;piggybackCommand&quot;: {
-             &quot;type&quot;: &quot;connectivity.commands:createConnection&quot;,
-             &quot;connection&quot;: {
-               &quot;id&quot;: &quot;command-and-control-connection&quot;,
-               &quot;connectionType&quot;: &quot;amqp-10&quot;,
-               &quot;connectionStatus&quot;: &quot;open&quot;,
-               &quot;uri&quot;: &quot;amqp://consumer%40HONO:verysecret@hono.eclipse.org:15672&quot;,
-               &quot;failoverEnabled&quot;: true,
-               &quot;sources&quot;: [{
-                   &quot;addresses&quot;: [
-                     &quot;control/org.eclipse.ditto/replies&quot;
-                   ],
-                   &quot;authorizationContext&quot;: [
-                     &quot;nginx:demo5&quot;
-                   ],
-                   &quot;headerMapping&quot;: {
-                     &quot;correlation-id&quot;: &quot;{{ header:correlation-id }}&quot;,
-                     &quot;status&quot;: &quot;{{ header:status }}&quot;,
-                     &quot;content-type&quot;: &quot;{{ header:content-type }}&quot;
-                   }
-                 }
-               ],
-               &quot;targets&quot;: [{
-                   &quot;address&quot;: &quot;control/org.eclipse.ditto/{{ thing:name }}&quot;,
-                   &quot;authorizationContext&quot;: [
-                     &quot;nginx:demo5&quot;
-                   ],
-                   &quot;topics&quot;:[&quot;_/_/things/live/messages&quot;],
-                   &quot;headerMapping&quot;: {
-                     &quot;message-id&quot;: &quot;{{ header:correlation-id }}&quot;,
-                     &quot;subject&quot;: &quot;{{ topic:subject }}&quot;,
-                     &quot;content-type&quot;: &quot;application/vnd.eclipse.ditto+json&quot;,
-                     &quot;reply-to&quot;: &quot;control/org.eclipse.ditto/replies&quot;
-                   }
-                 }
-               ]
-             }
-           }
-         }'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    https://ditto.eclipse.org/devops/piggyback/connectivity?timeout&lt;span class=&quot;o&quot;&gt;=&lt;/span&gt;10000
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;As described in the 
-&lt;a href=&quot;https://www.eclipse.org/hono/&quot;&gt;Hono API description&lt;/a&gt; 
-a command message has three mandatory properties: &lt;code class=&quot;highlighter-rouge&quot;&gt;correlation-id&lt;/code&gt;, &lt;code class=&quot;highlighter-rouge&quot;&gt;subject&lt;/code&gt; and &lt;code class=&quot;highlighter-rouge&quot;&gt;reply-to&lt;/code&gt;, these are defined in the 
-target header mapping of the connection. 
-The source header mapping defines a mapping for &lt;code class=&quot;highlighter-rouge&quot;&gt;correlation-id&lt;/code&gt; and &lt;code class=&quot;highlighter-rouge&quot;&gt;status&lt;/code&gt; to internal headers, they are required 
-to properly map the Hono command response to a Ditto message response.&lt;/p&gt;
-
-&lt;h3 id=&quot;signal-availability-of-device&quot;&gt;Signal availability of device&lt;/h3&gt;
-
-&lt;p&gt;As we are using the Hono HTTP Adapter to connect our device, send telemetry and receive commands, the designated way 
-is therefor to signal readiness to receive a command by specifying the &lt;code class=&quot;highlighter-rouge&quot;&gt;hono-ttd&lt;/code&gt; parameter on an arbitrary event (for 
-detailed description please consult the 
-[Hono HTTP Adapter] (https://www.eclipse.org/hono/) 
-guide).&lt;/p&gt;
-
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; POST &lt;span class=&quot;nt&quot;&gt;-i&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; teapot@org.eclipse.ditto:teapot &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'hono-ttd: 60'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{
-           &quot;topic&quot;: &quot;org.eclipse.ditto/teapot/things/twin/commands/modify&quot;,
-           &quot;path&quot;: &quot;/features/water/properties/temperature&quot;,
-           &quot;value&quot;: 23
-         }'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     http://hono.eclipse.org:8080/telemetry
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;The request is now open to receive a command for 60 seconds before it is terminated.&lt;/p&gt;
-
-&lt;h3 id=&quot;send-a-ditto-message&quot;&gt;Send a Ditto message&lt;/h3&gt;
-
-&lt;p&gt;Now we can use the &lt;a href=&quot;protocol-specification-things-messages.html#using-the-messages-api&quot;&gt;Ditto Messages API&lt;/a&gt; to send a 
-message to the device waiting for a command:&lt;/p&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;curl &lt;span class=&quot;nt&quot;&gt;-i&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; POST &lt;span class=&quot;s1&quot;&gt;'https://ditto.eclipse.org/api/2/things/org.eclipse.ditto:teapot/inbox/messages/brew?timeout=60'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; demo5:demo &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'x-correlation-id: command-and-control'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{&quot;targetTemperature&quot;:85}'&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h3 id=&quot;device-receives-the-command&quot;&gt;Device receives the command&lt;/h3&gt;
-
-&lt;p&gt;The message is forwarded to Hono as configured in the connection and finally terminates the pending request we opened 
-before with a status code of &lt;code class=&quot;highlighter-rouge&quot;&gt;200 OK&lt;/code&gt;:&lt;/p&gt;
-&lt;div class=&quot;highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;HTTP/1.1 200 OK
-hono-command: brew
-hono-cmd-req-id: 013command-and-controlreplies
-Content-Type: application/octet-stream
-Content-Length: 17
-Connection: Keep-Alive
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Hono adds two headers besides the standard HTTP headers: &lt;code class=&quot;highlighter-rouge&quot;&gt;hono-command&lt;/code&gt; and &lt;code class=&quot;highlighter-rouge&quot;&gt;hono-cmd-req-id&lt;/code&gt;. 
-&lt;code class=&quot;highlighter-rouge&quot;&gt;hono-command&lt;/code&gt; contains the subject of the message and &lt;code class=&quot;highlighter-rouge&quot;&gt;hono-cmd-req-id&lt;/code&gt; identifies the messages and is used to 
-correlate the request and the response we are now going to send.&lt;/p&gt;
-
-&lt;h3 id=&quot;device-sends-a-command-response&quot;&gt;Device sends a command response&lt;/h3&gt;
-
-&lt;p&gt;We use the header value of &lt;code class=&quot;highlighter-rouge&quot;&gt;hono-cmd-req-id&lt;/code&gt; to construct the response address: 
-&lt;code class=&quot;highlighter-rouge&quot;&gt;http://hono.eclipse.org:8080/control/res/013command-and-controlreplies&lt;/code&gt;&lt;/p&gt;
-
-&lt;p&gt;Another curl command completes the roundtrip with a response from the simulated device:&lt;/p&gt;
-
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;curl &lt;span class=&quot;nt&quot;&gt;-i&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; POST &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; teapot@org.eclipse.ditto:teapot &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'hono-cmd-status: 200'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{
-           &quot;topic&quot;: &quot;org.eclipse.ditto/teapot/things/live/messages/brew&quot;,
-           &quot;headers&quot;: {
-             &quot;content-type&quot;: &quot;application/json&quot;,
-             &quot;correlation-id&quot;: &quot;command-and-control&quot;
-           },
-           &quot;path&quot;: &quot;/inbox/messages/brew&quot;,
-           &quot;value&quot;: { &quot;eta&quot;: 56},
-           &quot;status&quot;: 200
-         }'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-     http://hono.eclipse.org:8080/control/res/013command-and-controlreplies
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h3 id=&quot;message-response-is-received-at-ditto-message-api&quot;&gt;Message response is received at Ditto Message API&lt;/h3&gt;
-&lt;p&gt;And finally we receive the command response at the Ditto Message API where we sent the original message:&lt;/p&gt;
-
-&lt;div class=&quot;highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;HTTP/1.1 200 OK
-correlation-id: command-and-control
-message-id: command-and-control
-status: 200
-Content-Type: application/json
-Content-Length: 10
-
-{&quot;eta&quot;:56}
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h3 id=&quot;alternative-receive-command-and-send-response-via-mqtt&quot;&gt;Alternative: Receive command and send response via MQTT&lt;/h3&gt;
-
-&lt;p&gt;Alternatively we can also receive the command by subscribing to the MQTT topic &lt;code class=&quot;highlighter-rouge&quot;&gt;control/+/+/req/#&lt;/code&gt; at the 
-&lt;a href=&quot;https://www.eclipse.org/hono/&quot;&gt;Hono MQTT Adapter&lt;/a&gt;:&lt;/p&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;nv&quot;&gt;$ &lt;/span&gt;mosquitto_sub &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-h&lt;/span&gt; hono.eclipse.org &lt;span class=&quot;nt&quot;&gt;-p&lt;/span&gt; 8883 &lt;span class=&quot;nt&quot;&gt;-v&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'teapot@org.eclipse.ditto'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-P&lt;/span&gt; teapot &lt;span class=&quot;nt&quot;&gt;-t&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'control/+/+/req/#'&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;And also publish the command response on the MQTT topic &lt;code class=&quot;highlighter-rouge&quot;&gt;control///res/013command-and-controlreplies/200&lt;/code&gt;:&lt;/p&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;mosquitto_pub &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-h&lt;/span&gt; hono.eclipse.org &lt;span class=&quot;nt&quot;&gt;-p&lt;/span&gt; 8883 &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'teapot@org.eclipse.ditto'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-P&lt;/span&gt; teapot &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-              &lt;span class=&quot;nt&quot;&gt;-t&lt;/span&gt; control///res/013command-and-controlreplies/200 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-              &lt;span class=&quot;nt&quot;&gt;-m&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{
-                    &quot;topic&quot;: &quot;org.eclipse.ditto/teapot/things/live/messages/brew&quot;,
-                    &quot;headers&quot;: {
-                      &quot;content-type&quot;: &quot;application/json&quot;,
-                      &quot;correlation-id&quot;: &quot;command-and-control&quot;
-                    },
-                    &quot;path&quot;: &quot;/inbox/messages/brew&quot;,
-                    &quot;value&quot;: {
-                      &quot;eta&quot;: 58
-                    },
-                    &quot;status&quot;: 200
-                  }'&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;If you have any wishes, improvements, are missing something
-or just want to get in touch with us, you can use one of
-our &lt;a href=&quot;feedback.html&quot;&gt;feedback channels&lt;/a&gt;.&lt;/p&gt;
-
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Wed, 05 Dec 2018 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2018-12-05-example-command-and-control.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2018-12-05-example-command-and-control.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-    </channel>
-</rss>
diff --git a/1.0/sitemap.xml b/1.0/sitemap.xml
deleted file mode 100644
index 20bc176..0000000
--- a/1.0/sitemap.xml
+++ /dev/null
@@ -1,805 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-12-12-release-announcement-100.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-11-04-milestone-announcement-100-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-10-17-http-connectivity.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-09-17-milestone-announcement-100-M1a.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-08-28-openid-connect.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-07-10-release-announcement-090.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-04-29-milestone-announcement-090-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-03-28-milestone-announcement-090-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-03-13-kafka-connectivity.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-12-05-example-command-and-control.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-11-28-release-announcement-080.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-11-14-milestone-announcement-080-M3.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-10-16-example-mqtt-bidirectional.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-09-27-milestone-announcement-080-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-09-21-selective-push-notifications.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-08-14-milestone-announcement-080-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-06-15-milestone-announcement-030-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-05-02-connecting-ditto-hono.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-04-26-milestone-announcement-030-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-04-25-connectivity-service.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-02-08-feature-definition.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-02-07-milestone-announcement-020-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-01-15-example-demonstrating-rest-to-websocket.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-01-12-milestone-announcement-010-M3.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2017-12-18-milestone-announcement-010-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2017-11-10-welcome-to-ditto.html</loc>
-  </url>
-  
-  
-
-
-  
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-concierge.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-connectivity.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-gateway.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-policies.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-things-search.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-things.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-acl.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-apis.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-auth.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-changenotifications.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-connections.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-feature.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-messages.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-namespaces-and-names.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-placeholders.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-policy.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-rql.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-search.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-signals-command.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-signals-commandresponse.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-signals-errorresponse.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-signals-event.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-signals.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-thing.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/blog.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/blog_archive.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/client-sdk-java.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/client-sdk-javascript.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/client-sdk-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-header-mapping.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-manage-connections.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-mapping.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-amqp091.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-amqp10.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-http.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-kafka2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-mqtt.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-tls-certificates.html</loc>
-  </url>
-  
-  
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/feedback.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/glossary.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/http-api-doc.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-concepts.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-messages.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-postman.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-protocol-bindings-websocket.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-search.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-sse.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/index.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/installation-building.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/installation-operating.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/installation-running.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/intro-digitaltwins.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/intro-hello-world.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/intro-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/presentations.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-bindings.html</loc>
-  </url>
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-examples.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things-create-or-modify.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things-delete.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things-messages.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things-retrieve.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things-search.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-topic.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-twinlive.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_010-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_010-M3.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_020-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_030-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_030-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_080.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_080-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_080-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_080-M3.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_090.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_090-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_090-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_100.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_100-M1a.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_100-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/sandbox.html</loc>
-  </url>
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/robots.txt</loc>
-  </url>
-  
-  
-</urlset>
\ No newline at end of file
diff --git a/1.1/feed.xml b/1.1/feed.xml
deleted file mode 100644
index c2cea44..0000000
--- a/1.1/feed.xml
+++ /dev/null
@@ -1,1095 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
-    <channel>
-        <title>Eclipse Ditto Blog</title>
-        <description>Announcements, tutorials and examples around Eclipse Ditto and Digital Twins</description>
-        <link>https://www.eclipse.org/ditto/</link>
-        <atom:link href="https://www.eclipse.org/ditto/feed.xml" rel="self" type="application/rss+xml"/>
-        <pubDate>Wed, 29 Apr 2020 09:06:10 +0000</pubDate>
-        <lastBuildDate>Wed, 29 Apr 2020 09:06:10 +0000</lastBuildDate>
-        <generator>Jekyll v3.6.2</generator>
-        
-        <item>
-            <title>Announcing Eclipse Ditto Release 1.1.0</title>
-            <description>&lt;p&gt;Today, approximately 4 months after Eclipse Ditto’s &lt;a href=&quot;2019-12-12-release-announcement-100.html&quot;&gt;1.0.0&lt;/a&gt; release, 
-the team is happy to announce the first minor (feature) update of Ditto &lt;code class=&quot;highlighter-rouge&quot;&gt;1.0&lt;/code&gt;:&lt;br /&gt;
-&lt;strong&gt;Eclipse Ditto 1.1.0&lt;/strong&gt;&lt;/p&gt;
-
-&lt;p&gt;The Ditto team was quite busy, 1.1.0 focuses on the following areas:&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;Management of &lt;a href=&quot;basic-policy.html&quot;&gt;Policies&lt;/a&gt; via &lt;a href=&quot;protocol-specification-policies.html&quot;&gt;Ditto Protocol&lt;/a&gt;
-    &lt;ul&gt;
-      &lt;li&gt;Addition of policy APIs in Ditto &lt;a href=&quot;client-sdk-java.html&quot;&gt;Java client&lt;/a&gt;&lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-  &lt;li&gt;Possibility to &lt;a href=&quot;basic-search.html&quot;&gt;search&lt;/a&gt; via &lt;a href=&quot;protocol-specification-things-search.html&quot;&gt;Ditto Protocol&lt;/a&gt;
-    &lt;ul&gt;
-      &lt;li&gt;Addition of search APIs in Ditto &lt;a href=&quot;client-sdk-java.html&quot;&gt;Java client&lt;/a&gt;&lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-  &lt;li&gt;Enrich published Ditto events/message via additional &lt;a href=&quot;basic-enrichment.html&quot;&gt;custom fields&lt;/a&gt; of the affected thing
-    &lt;ul&gt;
-      &lt;li&gt;Addition of enrichment APIs in Ditto &lt;a href=&quot;client-sdk-java.html&quot;&gt;Java client&lt;/a&gt;&lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-  &lt;li&gt;Support for establishing managed &lt;a href=&quot;basic-connections.html&quot;&gt;connections&lt;/a&gt; via &lt;a href=&quot;connectivity-protocol-bindings-mqtt5.html&quot;&gt;MQTT 5&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;End-2-end &lt;a href=&quot;basic-acknowledgements.html&quot;&gt;acknowledgements&lt;/a&gt; preparing Ditto to enable “at least once” processing
-    &lt;ul&gt;
-      &lt;li&gt;Addition of acknowledgement APIs in Ditto &lt;a href=&quot;client-sdk-java.html&quot;&gt;Java client&lt;/a&gt;&lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-  &lt;li&gt;Officially documented &lt;a href=&quot;installation-operating.html#pre-authentication&quot;&gt;pre-authenticated&lt;/a&gt; authentication mechanism&lt;/li&gt;
-  &lt;li&gt;Use of Java 11 for running Ditto containers&lt;/li&gt;
-  &lt;li&gt;Deprecation of API version 1 (authorization via &lt;a href=&quot;basic-acl.html&quot;&gt;ACL&lt;/a&gt; mechanism)&lt;/li&gt;
-  &lt;li&gt;Use of CBOR as cluster internal replacement for JSON serialization&lt;/li&gt;
-  &lt;li&gt;Further improvements on increasing throughput&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Please have a look at the &lt;a href=&quot;release_notes_110.html&quot;&gt;1.1.0 release notes&lt;/a&gt; for a more detailed information on the release.&lt;/p&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;Also the &lt;a href=&quot;client-sdk-java.html&quot;&gt;Ditto Java client&lt;/a&gt;’s artifacts were published to Maven central.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;kubernetes-ready-helm-chart&quot;&gt;Kubernetes ready: Helm chart&lt;/h2&gt;
-
-&lt;p&gt;In order to run Eclipse Ditto in a Kubernetes environment, best rely on the official 
-&lt;a href=&quot;https://hub.helm.sh/charts/eclipse-iot/ditto&quot;&gt;Helm chart&lt;/a&gt; and deploy Ditto via the Helm package manager.&lt;/p&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Wed, 29 Apr 2020 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2020-04-29-release-announcement-110.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2020-04-29-release-announcement-110.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Digital twins of devices connected via LoRaWAN to TTN</title>
-            <description>&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/2020-04-16-Logo_TTVC_color.png&quot; alt=&quot;TTVC logo&quot; style=&quot;max-width:300px;padding-left:1em;float:right&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;&lt;br /&gt;&lt;/p&gt;
-
-&lt;p&gt;A workshop of the &lt;a href=&quot;https://www.thethingsnetwork.org/article/the-things-virtual-conference&quot;&gt;2020 The Things Virtual Conference&lt;/a&gt;
-on April 16th 2020 is/was about how to connect Eclipse Ditto to “The Things Network” via TTN’s MQTT broker in order to 
-automatically update digital twins of devices connected via LoRaWAN to the TTN backend.&lt;/p&gt;
-
-&lt;p&gt;You can find the slides &lt;a href=&quot;slides/2020_04_16-ttn-virtual-conference/index.html&quot;&gt;here&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;This blogpost helps setting up this kind of connection and shall also be used as a step-by-step tutorial during
- the workshop.&lt;/p&gt;
-
-&lt;iframe width=&quot;560&quot; height=&quot;315&quot; src=&quot;https://www.youtube-nocookie.com/embed/D33JrN2RWiI&quot; frameborder=&quot;0&quot; allow=&quot;accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture&quot; allowfullscreen=&quot;&quot;&gt;&lt;/iframe&gt;
-
-&lt;h2 id=&quot;requirements&quot;&gt;Requirements&lt;/h2&gt;
-
-&lt;p&gt;You’ll need:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;an operating system capable of running Docker (best use a Linux distribution)&lt;/li&gt;
-  &lt;li&gt;4 CPU cores and 4GB of RAM are advised (less can work, but the Ditto cluster startup is more fragile then)&lt;/li&gt;
-  &lt;li&gt;to have installed: &lt;code class=&quot;highlighter-rouge&quot;&gt;curl&lt;/code&gt; and &lt;code class=&quot;highlighter-rouge&quot;&gt;git&lt;/code&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Also, you’ll need a TTN account and an existing application with at least one device if you want to follow the hands-on
-part and want to create digital twins of your devices connected to TTN.&lt;/p&gt;
-
-&lt;h2 id=&quot;preparation&quot;&gt;Preparation&lt;/h2&gt;
-
-&lt;p&gt;Please follow these initial preparation steps (if you don’t already have Docker and Docker Compose installed).&lt;/p&gt;
-
-&lt;p&gt;When you have access to a Kubernetes cluster and already have worked with &lt;a href=&quot;https://helm.sh&quot;&gt;Helm&lt;/a&gt; (the package manager
-for Kubernetes), you can alternatively install Ditto via its official 
-&lt;a href=&quot;https://hub.helm.sh/charts/eclipse-iot/ditto&quot;&gt;Helm chart&lt;/a&gt;.&lt;/p&gt;
-
-&lt;h3 id=&quot;install-docker&quot;&gt;Install Docker&lt;/h3&gt;
-
-&lt;p&gt;Assumption: You’re running a Debian or Ubuntu based Linux distribution containing the &lt;code class=&quot;highlighter-rouge&quot;&gt;apt&lt;/code&gt; package manager.&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;nb&quot;&gt;sudo &lt;/span&gt;apt install docker.io
-&lt;span class=&quot;nb&quot;&gt;sudo &lt;/span&gt;service docker start
-&lt;span class=&quot;nb&quot;&gt;sudo &lt;/span&gt;usermod &lt;span class=&quot;nt&quot;&gt;-a&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-G&lt;/span&gt; docker &amp;lt;your-username&amp;gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Logout and login again so that your user gets the “docker” group.&lt;/p&gt;
-
-&lt;h3 id=&quot;install-docker-compose&quot;&gt;Install Docker Compose&lt;/h3&gt;
-
-&lt;p&gt;&lt;a href=&quot;https://docs.docker.com/compose/install/&quot;&gt;Follow the installation guide here&lt;/a&gt;, in short:&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;nb&quot;&gt;sudo &lt;/span&gt;curl &lt;span class=&quot;nt&quot;&gt;-L&lt;/span&gt; &lt;span class=&quot;s2&quot;&gt;&quot;https://github.com/docker/compose/releases/download/1.25.4/docker-compose-&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;$(&lt;/span&gt;uname &lt;span class=&quot;nt&quot;&gt;-s&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;)&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;$(&lt;/span&gt;uname &lt;span class=&quot;nt&quot;&gt;-m&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;)&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-o&lt;/span&gt; /usr/local/bin/docker-compose
-&lt;span class=&quot;nb&quot;&gt;sudo &lt;/span&gt;chmod +x /usr/local/bin/docker-compose
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h3 id=&quot;clone-ditto-codebase&quot;&gt;Clone Ditto codebase&lt;/h3&gt;
-
-&lt;p&gt;That is required to get the &lt;code class=&quot;highlighter-rouge&quot;&gt;docker-compose.yaml&lt;/code&gt; file and other resources required to run Ditto with Docker Compose.&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;git clone &lt;span class=&quot;nt&quot;&gt;--depth&lt;/span&gt; 1 https://github.com/eclipse/ditto.git
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h2 id=&quot;startup-ditto-cluster&quot;&gt;Startup Ditto cluster&lt;/h2&gt;
-
-&lt;p&gt;Change directory into the just cloned git repository - optionally adjust the &lt;code class=&quot;highlighter-rouge&quot;&gt;DITTO_EXTERNAL_PORT&lt;/code&gt; variable to where 
-Ditto is reachable after the start:&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;nb&quot;&gt;cd &lt;/span&gt;ditto/deployment/docker/
-&lt;span class=&quot;nb&quot;&gt;export &lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;DITTO_EXTERNAL_PORT&lt;/span&gt;&lt;span class=&quot;o&quot;&gt;=&lt;/span&gt;80
-docker-compose up &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Verify that Ditto is running:&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;docker-compose ps
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;The output should look similar like this:&lt;/p&gt;
-&lt;div class=&quot;highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;         Name                       Command               State           Ports         
-----------------------------------------------------------------------------------------
-docker_concierge_1       /sbin/tini -- java -jar st ...   Up      8080/tcp              
-docker_connectivity_1    /sbin/tini -- java -jar st ...   Up      8080/tcp              
-docker_gateway_1         /sbin/tini -- java -Dditto ...   Up      0.0.0.0:8081-&amp;gt;8080/tcp
-docker_mongodb_1         docker-entrypoint.sh mongo ...   Up      27017/tcp             
-docker_nginx_1           nginx -g daemon off;             Up      0.0.0.0:80-&amp;gt;80/tcp    
-docker_policies_1        /sbin/tini -- java -jar st ...   Up      8080/tcp              
-docker_swagger-ui_1      nginx -g daemon off;             Up      80/tcp, 8080/tcp      
-docker_things-search_1   /sbin/tini -- java -jar st ...   Up      8080/tcp              
-docker_things_1          /sbin/tini -- java -jar st ...   Up      8080/tcp
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Verify that your Ditto cluster is healthy. Please give it ~1 minute in order to properly start up.&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;curl &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; devops:foobar http://localhost:&lt;span class=&quot;k&quot;&gt;${&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;DITTO_EXTERNAL_PORT&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;}&lt;/span&gt;/status/health
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;The returned output should start with:&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;label&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;roles&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;status&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;UP&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;err&quot;&gt;...&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;If your Ditto cluster has trouble starting up (e.g. because you only have less CPU cores than advised), try the following
-startup command instead:&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;docker-compose start mongodb&lt;span class=&quot;p&quot;&gt;;&lt;/span&gt; sleep 30&lt;span class=&quot;p&quot;&gt;;&lt;/span&gt; docker-compose start policies things&lt;span class=&quot;p&quot;&gt;;&lt;/span&gt; sleep 60&lt;span class=&quot;p&quot;&gt;;&lt;/span&gt; docker-compose start concierge&lt;span class=&quot;p&quot;&gt;;&lt;/span&gt; sleep 60&lt;span class=&quot;p&quot;&gt;;&lt;/span&gt; docker-compose start things-search&lt;span class=&quot;p&quot;&gt;;&lt;/span&gt; sleep 60&lt;span class=&quot;p&quot;&gt;;&lt;/span&gt; docker-compose start connectivity&lt;span class=&quot;p&quot;&gt;;&lt;/span&gt; sleep 60&lt;span class=&quot;p&quot;&gt;;&lt;/span&gt; docker-compose up &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h2 id=&quot;configure-connection-to-ttn-mqtt-broker&quot;&gt;Configure connection to TTN MQTT broker&lt;/h2&gt;
-
-&lt;p&gt;The Things Network provides a built in MQTT broker which you can connect to using your TTN application credentials.
-For a more detailed description on that topic, please refer to the 
-&lt;a href=&quot;https://www.thethingsnetwork.org/docs/applications/mqtt/quick-start.html&quot;&gt;TTN MQTT Quick Start&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;Eclipse Ditto can establish connections to MQTT brokers. This is a schematic picture of what we now will do:&lt;/p&gt;
-
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/../slides/images/ttn-ditto-via-mqtt.png&quot; alt=&quot;TTN to Ditto via MQTT&quot; style=&quot;max-width:600px;padding-left:1em&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;In order to connect to your own TTN application, perform the following steps.&lt;/p&gt;
-
-&lt;p&gt;You can find the &lt;code class=&quot;highlighter-rouge&quot;&gt;&amp;lt;AppId&amp;gt;&lt;/code&gt; (application ID) and &lt;code class=&quot;highlighter-rouge&quot;&gt;&amp;lt;AppKey&amp;gt;&lt;/code&gt; (access key) in your TTN console of your application.
-For &lt;code class=&quot;highlighter-rouge&quot;&gt;&amp;lt;Region&amp;gt;&lt;/code&gt;, e.g. choose &lt;code class=&quot;highlighter-rouge&quot;&gt;'eu'&lt;/code&gt; when your application is in handled by the Handler ‘ttn-handler-eu’.&lt;/p&gt;
-
-&lt;p&gt;Please export your application’s credentials locally to environment variables:&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;nb&quot;&gt;export &lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;TTN_REGION&lt;/span&gt;&lt;span class=&quot;o&quot;&gt;=&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'&amp;lt;Region&amp;gt;'&lt;/span&gt;
-&lt;span class=&quot;nb&quot;&gt;export &lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;TTN_APP_ID&lt;/span&gt;&lt;span class=&quot;o&quot;&gt;=&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'&amp;lt;AppID&amp;gt;'&lt;/span&gt;
-&lt;span class=&quot;nb&quot;&gt;export &lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;TTN_APP_KEY&lt;/span&gt;&lt;span class=&quot;o&quot;&gt;=&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'&amp;lt;AppKey&amp;gt;'&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;After having done that, you can already create the connection of Ditto to the TTN MQTT broker:&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; POST &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; devops:foobar &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{
-    &quot;targetActorSelection&quot;: &quot;/system/sharding/connection&quot;,
-    &quot;headers&quot;: {
-        &quot;aggregate&quot;: false
-    },
-    &quot;piggybackCommand&quot;: {
-        &quot;type&quot;: &quot;connectivity.commands:createConnection&quot;,
-        &quot;connection&quot;: {
-            &quot;id&quot;: &quot;ttn-connection-via-mqtt&quot;,
-            &quot;name&quot;: &quot;TTN-MQTT&quot;,
-            &quot;connectionType&quot;: &quot;mqtt&quot;,
-            &quot;connectionStatus&quot;: &quot;open&quot;,
-            &quot;uri&quot;: &quot;tcp://'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;${&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;TTN_APP_ID&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;':'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;${&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;TTN_APP_KEY&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'@'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;${&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;TTN_REGION&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'.thethings.network:1883&quot;,
-            &quot;failoverEnabled&quot;: true,
-            &quot;clientCount&quot;: 1,
-            &quot;validateCertificates&quot;: false,
-            &quot;sources&quot;: [{
-                &quot;addresses&quot;: [
-                    &quot;'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;${&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;TTN_APP_ID&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'/devices/+/up&quot;
-                ],
-                &quot;consumerCount&quot;: 1,
-                &quot;qos&quot;: 0,
-                &quot;authorizationContext&quot;: [
-                  &quot;pre-authenticated:ttn-connection&quot;
-                ],
-                &quot;enforcement&quot;: {
-                    &quot;input&quot;: &quot;{{ source:address }}&quot;,
-                    &quot;filters&quot;: [
-                        &quot;'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;${&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;TTN_APP_ID&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'/devices/{{ thing:name }}/up&quot;
-                    ]
-                },
-                &quot;replyTarget&quot;: {
-                    &quot;enabled&quot;: false
-                },
-                &quot;payloadMapping&quot;: [
-                    &quot;ttn-demo-mapping&quot;
-                ]
-            }],
-            &quot;mappingDefinitions&quot;: {
-                &quot;ttn-demo-mapping&quot;: {
-                     &quot;mappingEngine&quot;: &quot;JavaScript&quot;,
-                     &quot;options&quot;: {
-                         &quot;incomingScript&quot;: &quot;function mapToDittoProtocolMsg(\n  headers,\n  textPayload,\n  bytePayload,\n  contentType\n) {\n\n  let ttnJson = JSON.parse(textPayload);\n  let deviceId = ttnJson['&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'dev_id'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'];\n  let payloadFields = ttnJson['&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'payload_fields'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'];\n  \n  let attributesObj = {\n    hardwareSerial: ttnJson['&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'hardware_serial'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'],\n    ttnCounter: ttnJson['&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'counter'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;']\n  };\n  \n  let featuresObj = {\n    temperature: {\n      properties: {\n        value: payloadFields['&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'temperature_7'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;']\n      }\n    },\n    pressure: {\n      properties: {\n        value: payloadFields['&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'barometric_pressure_10'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;']\n      }\n    },\n    humidity: {\n      properties: {\n        value: payloadFields['&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'relative_humidity_8'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;']\n      }\n    }\n  };\n  \n  let thing = {\n    attributes: attributesObj,\n    features: featuresObj\n  };\n  \n  let dittoHeaders = {\n    '&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'response-required'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;': false,\n    '&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'If-Match'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;': '&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'*'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'\n  };\n\n  return Ditto.buildDittoProtocolMsg(\n    '&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'org.eclipse.ditto.ttn.demo'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;',\n    deviceId,\n    '&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'things'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;',\n    '&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'twin'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;',\n    '&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'commands'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;',\n    '&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'modify'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;',\n    '&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'/'&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;'&quot;&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;',\n    dittoHeaders,\n    thing\n  );\n}&quot;,
-                         &quot;outgoingScript&quot;: &quot;function mapFromDittoProtocolMsg() { return null; }&quot;,
-                         &quot;loadBytebufferJS&quot;: &quot;false&quot;,
-                         &quot;loadLongJS&quot;: &quot;false&quot;
-                     }
-                }
-            }
-        }
-    }
-}'&lt;/span&gt; http://localhost:&lt;span class=&quot;k&quot;&gt;${&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;DITTO_EXTERNAL_PORT&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;}&lt;/span&gt;/devops/piggyback/connectivity?timeout&lt;span class=&quot;o&quot;&gt;=&lt;/span&gt;8s
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Explanation - what is done here:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;using curl with the &lt;code class=&quot;highlighter-rouge&quot;&gt;devops&lt;/code&gt; (admin) user and its initial password &lt;code class=&quot;highlighter-rouge&quot;&gt;foobar&lt;/code&gt; we create a connection of type &lt;code class=&quot;highlighter-rouge&quot;&gt;mqtt&lt;/code&gt; 
-(you can find further information on that in Ditto’s &lt;a href=&quot;connectivity-protocol-bindings-mqtt.html&quot;&gt;MQTT docs&lt;/a&gt;)&lt;/li&gt;
-  &lt;li&gt;we use the TTN application credentials in the configured &lt;code class=&quot;highlighter-rouge&quot;&gt;&quot;uri&quot;&lt;/code&gt;, connect via plain TCP 
-(SSL is also possible but in this case a little more complicated as the server certificate of the TTN MQTT broker
- would have to be imported)&lt;/li&gt;
-  &lt;li&gt;we add an entry in &lt;code class=&quot;highlighter-rouge&quot;&gt;&quot;sources&quot;&lt;/code&gt;:
-    &lt;ul&gt;
-      &lt;li&gt;defining the MQTT topic (&lt;code class=&quot;highlighter-rouge&quot;&gt;&quot;addresses&quot;&lt;/code&gt;) to subscribe to&lt;/li&gt;
-      &lt;li&gt;specifying in which &lt;code class=&quot;highlighter-rouge&quot;&gt;&quot;authorizationContext&quot;&lt;/code&gt; messages from this connection shall be executed&lt;/li&gt;
-      &lt;li&gt;defining in the &lt;code class=&quot;highlighter-rouge&quot;&gt;&quot;enforcement&quot;&lt;/code&gt; that, based on the MQTT topic, a device may only update the Ditto twin having the same name&lt;/li&gt;
-      &lt;li&gt;declaring that a custom payload mapping shall be applied for each incoming message&lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-  &lt;li&gt;in the &lt;code class=&quot;highlighter-rouge&quot;&gt;&quot;mappingDefinitions&quot;&lt;/code&gt; we define the previously used “ttn-demo-mapping” as JavaScript based mapping:
-    &lt;ul&gt;
-      &lt;li&gt;only an “incoming” script is defined as we don’t handle downstream messages to TTN in this example&lt;/li&gt;
-      &lt;li&gt;when you want to understand the script in more depth, please take a look at the &lt;a href=&quot;#javascript-payload-mapping-script-in-detail&quot;&gt;details about it&lt;/a&gt;&lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;div class=&quot;alert alert-success&quot; role=&quot;alert&quot;&gt;&lt;i class=&quot;fa fa-check-square-o&quot;&gt;&lt;/i&gt; &lt;b&gt;Tip:&lt;/b&gt; As you have other custom &lt;code class=&quot;highlighter-rouge&quot;&gt;payload_fields&lt;/code&gt; for your TTN devices, please adjust the script 
-                             if you want to see the device’s custom payload fields in your Ditto twins.&lt;/div&gt;
-
-&lt;h2 id=&quot;create-a-common-policy-for-the-twins-to-be-created&quot;&gt;Create a common policy for the twins to be created&lt;/h2&gt;
-
-&lt;p&gt;Eclipse Ditto secures each API access to the managed twins by applying authorization of the authenticated user.&lt;br /&gt;
-Those “rules” which authenticated user may access which twins are defined in &lt;a href=&quot;basic-policy.html&quot;&gt;Policies&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;In order to proceed with our scenario, we create a single Policy which shall be used for all twins we create in a later 
-step:&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; PUT &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; ditto:ditto &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{
-   &quot;policyId&quot;: &quot;org.eclipse.ditto.ttn.demo:twin-policy&quot;,
-   &quot;entries&quot;: {
-       &quot;USER&quot;: {
-           &quot;subjects&quot;: {
-              &quot;nginx:ditto&quot;: {
-                  &quot;type&quot;: &quot;basic auth user authenticated via nginx&quot;
-              }
-           },
-           &quot;resources&quot;: {
-               &quot;thing:/&quot;: {
-                   &quot;grant&quot;: [&quot;READ&quot;, &quot;WRITE&quot;],
-                   &quot;revoke&quot;: []
-               },
-               &quot;policy:/&quot;: {
-                   &quot;grant&quot;: [&quot;READ&quot;, &quot;WRITE&quot;],
-                   &quot;revoke&quot;: []
-               },
-               &quot;message:/&quot;: {
-                   &quot;grant&quot;: [&quot;READ&quot;, &quot;WRITE&quot;],
-                   &quot;revoke&quot;: []
-               }
-           }
-       },
-       &quot;TTN&quot;: {
-           &quot;subjects&quot;: {
-              &quot;pre-authenticated:ttn-connection&quot;: {
-                  &quot;type&quot;: &quot;used in the connections authorizationContext to the TTN MQTT&quot;
-              }
-           },
-           &quot;resources&quot;: {
-               &quot;thing:/&quot;: {
-                   &quot;grant&quot;: [&quot;WRITE&quot;],
-                   &quot;revoke&quot;: []
-               }
-           }
-       }
-   }
-}'&lt;/span&gt; http://localhost:&lt;span class=&quot;k&quot;&gt;${&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;DITTO_EXTERNAL_PORT&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;}&lt;/span&gt;/api/2/policies/org.eclipse.ditto.ttn.demo:twin-policy
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Explanation - what is done here:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;we create a new Policy with the ID &lt;code class=&quot;highlighter-rouge&quot;&gt;&quot;org.eclipse.ditto.ttn.demo:twin-policy&quot;&lt;/code&gt;&lt;/li&gt;
-  &lt;li&gt;it contains 2 entries:
-    &lt;ul&gt;
-      &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;&quot;USER&quot;&lt;/code&gt;: this Policy entry contains the authorization information of the user of the twin APIs (authenticated via the contained “nginx” acting as reverse proxy). 
- This user may READ+WRITE the things (twins), this created policy and may also send and receive messages.&lt;/li&gt;
-      &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;&quot;TTN&quot;&lt;/code&gt;: this Policy entry contains the authorization information of the connection to the TTN MQTT broker (the subject was configured as &lt;code class=&quot;highlighter-rouge&quot;&gt;&quot;authorizationContext&quot;&lt;/code&gt; when we created the connection. 
- This connection may only WRITE (update) the things (twins).&lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;create-digital-twins&quot;&gt;Create digital twins&lt;/h2&gt;
-
-&lt;p&gt;Now we have everything in place in order to create digital twins for our devices connected to TTN.&lt;/p&gt;
-
-&lt;p&gt;Please export all device ids you want to create digital twins for as comma separated environment variable:&lt;/p&gt;
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;nb&quot;&gt;export &lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;TTN_DEVICE_IDS&lt;/span&gt;&lt;span class=&quot;o&quot;&gt;=&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'&amp;lt;comma-separated-list-of-your-device-ids&amp;gt;'&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;After having done that, we can already create the twins in Ditto as the &lt;code class=&quot;highlighter-rouge&quot;&gt;ditto&lt;/code&gt; user:&lt;/p&gt;
-
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;k&quot;&gt;for &lt;/span&gt;dev_id &lt;span class=&quot;k&quot;&gt;in&lt;/span&gt; &lt;span class=&quot;k&quot;&gt;${&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;TTN_DEVICE_IDS&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;//,/ &lt;/span&gt;&lt;span class=&quot;k&quot;&gt;}&lt;/span&gt;
-&lt;span class=&quot;k&quot;&gt;do&lt;/span&gt;
-    &lt;span class=&quot;c&quot;&gt;# call your procedure/other scripts here below&lt;/span&gt;
-    &lt;span class=&quot;nb&quot;&gt;echo&lt;/span&gt; &lt;span class=&quot;s2&quot;&gt;&quot;Creating digital twin with Thing ID: org.eclipse.ditto.ttn.demo:&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;$dev_id&lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;&lt;/span&gt;
-    curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; PUT &lt;span class=&quot;nt&quot;&gt;-u&lt;/span&gt; ditto:ditto &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{
-       &quot;policyId&quot;: &quot;org.eclipse.ditto.ttn.demo:twin-policy&quot;
-    }'&lt;/span&gt; http://localhost:&lt;span class=&quot;k&quot;&gt;${&lt;/span&gt;&lt;span class=&quot;nv&quot;&gt;DITTO_EXTERNAL_PORT&lt;/span&gt;&lt;span class=&quot;k&quot;&gt;}&lt;/span&gt;/api/2/things/org.eclipse.ditto.ttn.demo:&lt;span class=&quot;nv&quot;&gt;$dev_id&lt;/span&gt;
-&lt;span class=&quot;k&quot;&gt;done&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Explanation - what is done here:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;we split the passed in &lt;code class=&quot;highlighter-rouge&quot;&gt;TTN_DEVICE_IDS&lt;/code&gt; environment variable by &lt;code class=&quot;highlighter-rouge&quot;&gt;,&lt;/code&gt; and iterate over all contained device ids&lt;/li&gt;
-  &lt;li&gt;for each device ID we create a new Thing (twin) referencing the already previously created Policy&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;access-your-digital-twins-via-api&quot;&gt;Access your digital twins via API&lt;/h2&gt;
-
-&lt;p&gt;Congratulations, if you have done it so far your TTN devices do now have digital twin representations in Eclipse Ditto.&lt;/p&gt;
-
-&lt;div class=&quot;alert alert-success&quot; role=&quot;alert&quot;&gt;&lt;i class=&quot;fa fa-check-square-o&quot;&gt;&lt;/i&gt; &lt;b&gt;Tip:&lt;/b&gt; Install the command line tool &lt;code class=&quot;highlighter-rouge&quot;&gt;jq&lt;/code&gt; and pipe the output of the below &lt;code class=&quot;highlighter-rouge&quot;&gt;curl&lt;/code&gt; commands to it in order to get
-                             prettified and colored JSON&lt;/div&gt;
-
-&lt;div class=&quot;alert alert-info&quot; role=&quot;alert&quot;&gt;&lt;i class=&quot;fa fa-info-circle&quot;&gt;&lt;/i&gt; &lt;b&gt;Note:&lt;/b&gt; Alternatively to &lt;code class=&quot;highlighter-rouge&quot;&gt;curl&lt;/code&gt;, you may also use the locally deployed swagger-ui at http://localhost:${DITTO_EXTERNAL_PORT}/apidoc/ 
-                              in order to try out Ditto’s HTTP API - &lt;em&gt;make sure to select&lt;/em&gt; &lt;code class=&quot;highlighter-rouge&quot;&gt;/api/2 - local Ditto&lt;/code&gt; in the ‘Servers’ 
-                              section - when asked for credentials, use username ‘ditto’ and password ‘ditto’&lt;/div&gt;
-
-&lt;p&gt;You can now, for example, use Ditto’s HTTP APIs in order&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;to retrieve the latest reported values: &lt;code class=&quot;highlighter-rouge&quot;&gt;curl -u ditto:ditto http://localhost:${DITTO_EXTERNAL_PORT}/api/2/things/org.eclipse.ditto.ttn.demo:&amp;lt;dev_id&amp;gt;&lt;/code&gt;&lt;/li&gt;
-  &lt;li&gt;to get a live stream of updates to the twins using SSE (Server Sent Events): &lt;code class=&quot;highlighter-rouge&quot;&gt;curl --http2 -u ditto:ditto -H 'Accept:text/event-stream' -N http://localhost:${DITTO_EXTERNAL_PORT}/api/2/things&lt;/code&gt;&lt;/li&gt;
-  &lt;li&gt;to list all available twins via the search API: &lt;code class=&quot;highlighter-rouge&quot;&gt;curl -u ditto:ditto http://localhost:${DITTO_EXTERNAL_PORT}/api/2/search/things&lt;/code&gt;
-    &lt;ul&gt;
-      &lt;li&gt;alternatively, use your browser and open http://localhost:${DITTO_EXTERNAL_PORT}/api/2/search/things&lt;/li&gt;
-      &lt;li&gt;when asked for credentials, use username “ditto” and password “ditto”&lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-  &lt;li&gt;formulate a search query, e.g. only searching for twins with a temperature above 24°, sorted by the last modification, the most recent first
-to get the most active twin as first result:
-    &lt;ul&gt;
-      &lt;li&gt;&lt;code class=&quot;highlighter-rouge&quot;&gt;curl -u ditto:ditto &quot;http://localhost:${DITTO_EXTERNAL_PORT}/api/2/search/things?filter=gt(features/temperature/properties/value,24.0)&amp;amp;option=sort(-_modified),size(5)&amp;amp;fields=thingId,policyId,attributes,features,_modified,_revision&quot;&lt;/code&gt;&lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;which-other-possibilities-do-we-now-have&quot;&gt;Which other possibilities do we now have?&lt;/h2&gt;
-
-&lt;p&gt;Now you have all the possibilities Eclipse Ditto as digital twin framework provides, e.g.:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;directly use your device’s data in a web application consuming Ditto’s HTTP API&lt;/li&gt;
-  &lt;li&gt;directly use your device’s data in a mobile app using Ditto’s bidirectional &lt;a href=&quot;httpapi-protocol-bindings-websocket.html&quot;&gt;WebSocket&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;make use of the &lt;a href=&quot;https://github.com/eclpise/ditto-clients/&quot;&gt;Eclipse Ditto Java or JavaScript clients&lt;/a&gt; which also use the WebSocket to integrate your device’s data&lt;/li&gt;
-  &lt;li&gt;create another connection (optionally also applying JavaScript based payload mapping)
-    &lt;ul&gt;
-      &lt;li&gt;to e.g. &lt;a href=&quot;connectivity-protocol-bindings-kafka2.html&quot;&gt;Apache Kafka&lt;/a&gt; and forward all the modifications made to your devices to there&lt;/li&gt;
-      &lt;li&gt;or using &lt;a href=&quot;connectivity-protocol-bindings-http.html&quot;&gt;HTTP push&lt;/a&gt; in order to call another HTTP API (e.g. insert time series data into an InfluxDB via its HTTP API)&lt;/li&gt;
-    &lt;/ul&gt;
-  &lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-
-&lt;p&gt;For time reasons we do not go deeper into additional topics, they are possible however, please consult the Ditto
-documentation:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;the WebSocket channel and subscribing for change notifications&lt;/li&gt;
-  &lt;li&gt;sending downward messages to devices&lt;/li&gt;
-  &lt;li&gt;live commands (not retrieving persisted data of devices, but live data)&lt;/li&gt;
-  &lt;li&gt;a more detailed introduction into authentication mechanisms (&lt;a href=&quot;installation-operating.html#openid-connect&quot;&gt;OpenID Connect with OAuth2.0 is possible&lt;/a&gt;)&lt;/li&gt;
-  &lt;li&gt;possibilities to configure your Policies on every resource level, e.g. allowing individuals to only access certain values of a twin&lt;/li&gt;
-  &lt;li&gt;and many other things..&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;additional-resources&quot;&gt;Additional resources&lt;/h2&gt;
-
-&lt;h3 id=&quot;cleanup-after-the-workshop&quot;&gt;Cleanup after the workshop&lt;/h3&gt;
-
-&lt;p&gt;Simply perform in the &lt;code class=&quot;highlighter-rouge&quot;&gt;ditto/deployment/docker&lt;/code&gt; folder:&lt;/p&gt;
-&lt;div class=&quot;language-shell highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;docker-compose down
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;And unistall docker + docker-compose (for docker-compose, just remove the downloaded file) again, if you don’t need it.&lt;/p&gt;
-
-&lt;h3 id=&quot;javascript-payload-mapping-script-in-detail&quot;&gt;JavaScript payload mapping script in detail&lt;/h3&gt;
-
-&lt;p&gt;Similar to the TTN console’s decoding/converting capabilities of “Payload Formats” of an TTN application, Ditto is able
-to apply a custom JavaScript function for each consumed message.&lt;br /&gt;
-That is necessary in order to convert the received data into a &lt;a href=&quot;protocol-overview.html&quot;&gt;Ditto Protocol&lt;/a&gt; message 
-including the JSON hierarchy of a so called &lt;a href=&quot;basic-thing.html&quot;&gt;Thing&lt;/a&gt; being the representation of a digital twin.&lt;/p&gt;
-
-&lt;p&gt;As the above injected JavaScript payload mapping script is formatted in a single line, this is the script we used pretty
- formatted, including the jsdoc of the provided function and some other inline comments.&lt;/p&gt;
-
-&lt;p&gt;If you need to adjust the script in order to use your own &lt;code class=&quot;highlighter-rouge&quot;&gt;payload_fields&lt;/code&gt;, please replace all newlines with &lt;code class=&quot;highlighter-rouge&quot;&gt;\n&lt;/code&gt; and
-escape the single quotes &lt;code class=&quot;highlighter-rouge&quot;&gt;'&lt;/code&gt; in the script with the following replacement: &lt;code class=&quot;highlighter-rouge&quot;&gt;'&quot;'&quot;'&lt;/code&gt;. Otherwise the single quotes won’t get
-correctly escaped in the bash. You can remove the comments before making a single line of the script.&lt;/p&gt;
-
-&lt;div class=&quot;language-javascript highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;cm&quot;&gt;/**
- * Maps the passed parameters to a Ditto Protocol message.
- * @param {Object.&amp;lt;string, string&amp;gt;} headers - The headers Object containing all received header values
- * @param {string} [textPayload] - The String to be mapped
- * @param {ArrayBuffer} [bytePayload] - The bytes to be mapped as ArrayBuffer
- * @param {string} [contentType] - The received Content-Type, e.g. &quot;application/json&quot;
- * @returns {(DittoProtocolMessage|Array&amp;lt;DittoProtocolMessage&amp;gt;)} dittoProtocolMessage(s) -
- *  The mapped Ditto Protocol message,
- *  an array of Ditto Protocol messages or
- *  &amp;lt;code&amp;gt;null&amp;lt;/code&amp;gt; if the message could/should not be mapped
- */&lt;/span&gt;
-&lt;span class=&quot;kd&quot;&gt;function&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;mapToDittoProtocolMsg&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;(&lt;/span&gt;
-  &lt;span class=&quot;nx&quot;&gt;headers&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;
-  &lt;span class=&quot;nx&quot;&gt;textPayload&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;
-  &lt;span class=&quot;nx&quot;&gt;bytePayload&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;
-  &lt;span class=&quot;nx&quot;&gt;contentType&lt;/span&gt;
-&lt;span class=&quot;p&quot;&gt;)&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;
-
-  &lt;span class=&quot;kd&quot;&gt;let&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;ttnJson&lt;/span&gt; &lt;span class=&quot;o&quot;&gt;=&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;JSON&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;nx&quot;&gt;parse&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;(&lt;/span&gt;&lt;span class=&quot;nx&quot;&gt;textPayload&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;);&lt;/span&gt;          &lt;span class=&quot;c1&quot;&gt;// we simply parse the incoming TTN message as JSON&lt;/span&gt;
-  &lt;span class=&quot;kd&quot;&gt;let&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;deviceId&lt;/span&gt; &lt;span class=&quot;o&quot;&gt;=&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;ttnJson&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'dev_id'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;];&lt;/span&gt;               &lt;span class=&quot;c1&quot;&gt;// and extract some fields we require&lt;/span&gt;
-  &lt;span class=&quot;kd&quot;&gt;let&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;payloadFields&lt;/span&gt; &lt;span class=&quot;o&quot;&gt;=&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;ttnJson&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'payload_fields'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;];&lt;/span&gt;  &lt;span class=&quot;c1&quot;&gt;// the 'payload_fields' content is - obviously - different for your application&lt;/span&gt;
-  
-  &lt;span class=&quot;kd&quot;&gt;let&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;attributesObj&lt;/span&gt; &lt;span class=&quot;o&quot;&gt;=&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;                           &lt;span class=&quot;c1&quot;&gt;// the attributes of a Thing are meant for unstructured data &lt;/span&gt;
-    &lt;span class=&quot;na&quot;&gt;hardwareSerial&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;ttnJson&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'hardware_serial'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;],&lt;/span&gt;
-    &lt;span class=&quot;na&quot;&gt;ttnCounter&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;ttnJson&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'counter'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;]&lt;/span&gt;
-  &lt;span class=&quot;p&quot;&gt;};&lt;/span&gt;
-  
-  &lt;span class=&quot;kd&quot;&gt;let&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;featuresObj&lt;/span&gt; &lt;span class=&quot;o&quot;&gt;=&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;                             &lt;span class=&quot;c1&quot;&gt;// the features of a Thing e.g. contain sensor data of devices&lt;/span&gt;
-    &lt;span class=&quot;na&quot;&gt;temperature&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;
-      &lt;span class=&quot;na&quot;&gt;properties&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;
-        &lt;span class=&quot;na&quot;&gt;value&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;payloadFields&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'temperature_7'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;]&lt;/span&gt;
-      &lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;
-    &lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;
-    &lt;span class=&quot;na&quot;&gt;pressure&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;
-      &lt;span class=&quot;na&quot;&gt;properties&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;
-        &lt;span class=&quot;na&quot;&gt;value&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;payloadFields&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'barometric_pressure_10'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;]&lt;/span&gt;
-      &lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;
-    &lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;
-    &lt;span class=&quot;na&quot;&gt;humidity&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;
-      &lt;span class=&quot;na&quot;&gt;properties&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;
-        &lt;span class=&quot;na&quot;&gt;value&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;payloadFields&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;s1&quot;&gt;'relative_humidity_8'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;]&lt;/span&gt;
-      &lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;
-    &lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;
-  &lt;span class=&quot;p&quot;&gt;};&lt;/span&gt;
-  
-  &lt;span class=&quot;kd&quot;&gt;let&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;thing&lt;/span&gt; &lt;span class=&quot;o&quot;&gt;=&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;                                   &lt;span class=&quot;c1&quot;&gt;// a Thing can contain both attributes and features&lt;/span&gt;
-    &lt;span class=&quot;na&quot;&gt;attributes&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;attributesObj&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;
-    &lt;span class=&quot;na&quot;&gt;features&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;featuresObj&lt;/span&gt;
-  &lt;span class=&quot;p&quot;&gt;};&lt;/span&gt;
-  
-  &lt;span class=&quot;kd&quot;&gt;let&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;dittoHeaders&lt;/span&gt; &lt;span class=&quot;o&quot;&gt;=&lt;/span&gt; &lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;
-    &lt;span class=&quot;s1&quot;&gt;'response-required'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;kc&quot;&gt;false&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;     &lt;span class=&quot;c1&quot;&gt;// we don't expect a response sent back to TTN&lt;/span&gt;
-    &lt;span class=&quot;s1&quot;&gt;'If-Match'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'*'&lt;/span&gt;                 &lt;span class=&quot;c1&quot;&gt;// we only want to update the thing if it already exists&lt;/span&gt;
-  &lt;span class=&quot;p&quot;&gt;};&lt;/span&gt;
-
-  &lt;span class=&quot;k&quot;&gt;return&lt;/span&gt; &lt;span class=&quot;nx&quot;&gt;Ditto&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;.&lt;/span&gt;&lt;span class=&quot;nx&quot;&gt;buildDittoProtocolMsg&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;(&lt;/span&gt;
-    &lt;span class=&quot;s1&quot;&gt;'org.eclipse.ditto.ttn.demo'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;   &lt;span class=&quot;c1&quot;&gt;// this is the namespace used as prefix for Ditto Thing IDs&lt;/span&gt;
-    &lt;span class=&quot;nx&quot;&gt;deviceId&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;                       &lt;span class=&quot;c1&quot;&gt;// the TTN device ID is used as &quot;name&quot; part of the Ditto Thing ID &lt;/span&gt;
-    &lt;span class=&quot;s1&quot;&gt;'things'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;
-    &lt;span class=&quot;s1&quot;&gt;'twin'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;
-    &lt;span class=&quot;s1&quot;&gt;'commands'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;
-    &lt;span class=&quot;s1&quot;&gt;'modify'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;
-    &lt;span class=&quot;s1&quot;&gt;'/'&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;
-    &lt;span class=&quot;nx&quot;&gt;dittoHeaders&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;
-    &lt;span class=&quot;nx&quot;&gt;thing&lt;/span&gt;
-  &lt;span class=&quot;p&quot;&gt;);&lt;/span&gt;
-&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;An example message received from the TTN MQTT broker:&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;app_id&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;iot-campus-be12&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;dev_id&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;node0&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;hardware_serial&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;70B3D5499A2D3954&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;port&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;2&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;counter&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;9449&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;payload_raw&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;B2cA6AhoKwpzJ8oEAwH4&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;payload_fields&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;analog_out_4&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mf&quot;&gt;5.04&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;barometric_pressure_10&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mf&quot;&gt;1018.6&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;relative_humidity_8&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mf&quot;&gt;21.5&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;temperature_7&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mf&quot;&gt;23.2&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;metadata&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;err&quot;&gt;...&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;would be transformed to the following Ditto Protocol message:&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;topic&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;org.eclipse.ditto/node0/things/twin/commands/modify&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;path&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;/&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;attributes&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;hardwareSerial&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;70B3D5499A2D3954&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;ttnCounter&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mi&quot;&gt;9449&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;features&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;temperature&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-         &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;properties&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-          &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mf&quot;&gt;23.2&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-        &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;pressure&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-        &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;properties&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-          &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mf&quot;&gt;1018.6&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-        &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;},&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;humidity&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-        &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;properties&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-          &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;mf&quot;&gt;21.5&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-        &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-      &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Thu, 16 Apr 2020 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2020-04-16-connecting-to-ttn-via-mqtt.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2020-04-16-connecting-to-ttn-via-mqtt.html</guid>
-            
-            <category>blog</category>
-            
-            <category>connectivity</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Eclipse Ditto Release 1.0.0</title>
-            <description>&lt;p&gt;Today the Eclipse Ditto is thrilled to announce the availability of Eclipse Ditto’s first major release
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0&quot;&gt;1.0.0&lt;/a&gt;.&lt;/p&gt;
-
-&lt;h2 id=&quot;maturity&quot;&gt;Maturity&lt;/h2&gt;
-
-&lt;p&gt;The initial code contribution was done in October 2017, 2 years later and 2 releases 
-(&lt;a href=&quot;2018-11-28-release-announcement-080.html&quot;&gt;0.8.0&lt;/a&gt; and &lt;a href=&quot;2019-07-10-release-announcement-090.html&quot;&gt;0.9.0&lt;/a&gt;) later, we 
-think its time to graduate from the Eclipse “incubation” phase and officially declare the project as mature.&lt;/p&gt;
-
-&lt;p&gt;Recent adoptions and contributions from our community show us that Eclipse Ditto solves problems which also other
-companies have. Adopters add Eclipse Ditto as a central part of their own IoT platforms.&lt;/p&gt;
-
-&lt;h3 id=&quot;api-stability&quot;&gt;API stability&lt;/h3&gt;
-
-&lt;p&gt;Having reached 1.0.0, some additional promises towards “API stability” do apply:&lt;/p&gt;
-
-&lt;h4 id=&quot;http-api-stability&quot;&gt;HTTP API stability&lt;/h4&gt;
-&lt;p&gt;Ditto uses schema versioning (currently schema version 1 and 2) at the HTTP API level in order to being able to 
-evolve APIs.
-It is backward compatible to the prior versions 0.8.0 and 0.9.0.&lt;/p&gt;
-
-&lt;h4 id=&quot;json-api-stability&quot;&gt;JSON API stability&lt;/h4&gt;
-&lt;p&gt;Ditto kept its main JSON APIs (regarding things, policies and search) backwards compatible to 0.8.0 and 0.9.0 releases.
-The JSON format of “connections” was changed since 0.9.0 and will from 1.0.0 on be kept backwards compatible as well.&lt;/p&gt;
-
-&lt;h4 id=&quot;java-api-stability&quot;&gt;Java API stability&lt;/h4&gt;
-&lt;p&gt;The Java APIs will for the 1.x release be kept backwards compatible, so only non-breaking additions to the APIs will be done. This is enforced by a Maven tooling.&lt;/p&gt;
-
-&lt;p&gt;The following Java modules are treated as API for which compatibility is enforced:&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;ditto-json&lt;/li&gt;
-  &lt;li&gt;ditto-model-*&lt;/li&gt;
-  &lt;li&gt;ditto-signals-*&lt;/li&gt;
-  &lt;li&gt;ditto-protocol-adapter&lt;/li&gt;
-  &lt;li&gt;ditto-utils&lt;/li&gt;
-  &lt;li&gt;ditto-client&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h3 id=&quot;scalability&quot;&gt;Scalability&lt;/h3&gt;
-
-&lt;p&gt;The focus on the 0.9.0 and 1.0.0 releases regarding non-functionals were laid on horizontal scalability.&lt;/p&gt;
-
-&lt;p&gt;With Eclipse Ditto 1.0.0 we are confident to face production grade scalability requirements being capable of handling 
-millions of managed things.&lt;/p&gt;
-
-&lt;h2 id=&quot;changelog&quot;&gt;Changelog&lt;/h2&gt;
-
-&lt;p&gt;The main changes compared to the last release, &lt;a href=&quot;release_notes_090.html&quot;&gt;0.9.0&lt;/a&gt;, are:&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;addition of a Java and a JavaScript client SDK in separate &lt;a href=&quot;https://github.com/eclipse/ditto-clients&quot;&gt;GitHub repo&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;configurable OpenID Connect authorization servers&lt;/li&gt;
-  &lt;li&gt;support for OpenID Connect / OAuth2.0 based authentication in Ditto Java Client&lt;/li&gt;
-  &lt;li&gt;invoking custom foreign HTTP endpoints as a result of events/messages&lt;/li&gt;
-  &lt;li&gt;ability to reflect Eclipse Hono’s device connection state in Ditto’s things&lt;/li&gt;
-  &lt;li&gt;configurable throttling of max. consumed WebSocket commands / time interval&lt;/li&gt;
-  &lt;li&gt;Addition of “definition” field in thing at model level containing the model ID a thing may follow&lt;/li&gt;
-  &lt;li&gt;Improved connection response handling/mapping&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Please have a look at the &lt;a href=&quot;release_notes_100.html&quot;&gt;1.0.0 release notes&lt;/a&gt; for a more detailed information on the release.&lt;/p&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Thu, 12 Dec 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-12-12-release-announcement-100.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-12-12-release-announcement-100.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Ditto Milestone 1.0.0-M2</title>
-            <description>&lt;p&gt;The second and last milestone of the upcoming release 
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0&quot;&gt;1.0.0&lt;/a&gt; was released today.&lt;/p&gt;
-
-&lt;p&gt;Have a look at the Milestone &lt;a href=&quot;release_notes_100-M2.html&quot;&gt;1.0.0-M2 release notes&lt;/a&gt; for what changed in detail.&lt;/p&gt;
-
-&lt;p&gt;The main changes and new features since the last release &lt;a href=&quot;release_notes_100-M1a.html&quot;&gt;1.0.0-M1a release notes&lt;/a&gt; are&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;invoking custom foreign HTTP endpoints as a result of events/messages&lt;/li&gt;
-  &lt;li&gt;ability to reflect Eclipse Hono’s device connection state in Ditto’s things&lt;/li&gt;
-  &lt;li&gt;support for OpenID Connect / OAuth2.0 based authentication in Ditto Java Client&lt;/li&gt;
-  &lt;li&gt;configurbale throttling of max. consumed WebSocket commands / time interval&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Mon, 04 Nov 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-11-04-milestone-announcement-100-M2.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-11-04-milestone-announcement-100-M2.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Integration of HTTP endpoints/webhooks</title>
-            <description>&lt;p&gt;By adding another connectivity type - &lt;a href=&quot;connectivity-protocol-bindings-http.html&quot;&gt;HTTP&lt;/a&gt; - to Ditto’s 
- connectivity, it is now (to be released in the next Ditto milestone 1.0.0-M2) possible to to 
- publish &lt;em&gt;twin events&lt;/em&gt;, &lt;em&gt;messages&lt;/em&gt;, &lt;em&gt;live commands and events&lt;/em&gt; to existing HTTP servers/endpoints.&lt;/p&gt;
-
-&lt;p&gt;That is especially useful for invoking existing APIs (which are most of the time HTTP based) whenever e.g.
- a digital twin was modified.&lt;/p&gt;
-
-&lt;p&gt;One example on how to benefit from this new feature is to invoke a custom 
- &lt;a href=&quot;https://ifttt.com&quot;&gt;IFTTT&lt;/a&gt; (if-this-than-that) &lt;a href=&quot;https://ifttt.com/maker_webhooks&quot;&gt;webhook&lt;/a&gt; via a HTTP &lt;code class=&quot;highlighter-rouge&quot;&gt;POST&lt;/code&gt; request
- which then may trigger other IFTTT follow-up-actions (e.g. send a chat message to a &lt;a href=&quot;https://ifttt.com/slack&quot;&gt;Slack&lt;/a&gt; 
- room).&lt;/p&gt;
-
-&lt;p&gt;For IFTTT “webhooks” the address would be &lt;code class=&quot;highlighter-rouge&quot;&gt;POST https://maker.ifttt.com/trigger/&amp;lt;your-event-name&amp;gt;/with/key/&amp;lt;your-key&amp;gt;&lt;/code&gt; 
- and the expected JSON body:&lt;/p&gt;
-
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value1&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;...&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value2&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;...&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;value3&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;...&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;In combination with &lt;a href=&quot;connectivity-mapping.html&quot;&gt;payload mapping&lt;/a&gt;, the &lt;code class=&quot;highlighter-rouge&quot;&gt;value1&lt;/code&gt; to &lt;code class=&quot;highlighter-rouge&quot;&gt;value3&lt;/code&gt; fields requested by the IFTTT
-API can be extracted from the &lt;a href=&quot;protocol-specification.html&quot;&gt;Ditto Protocol&lt;/a&gt; and could contain the changed value.&lt;/p&gt;
-
-&lt;p&gt;In combination with &lt;a href=&quot;basic-connections.html#target-topics-and-filtering&quot;&gt;filters for targets&lt;/a&gt; you can even specify to
-only publish e.g. &lt;code class=&quot;highlighter-rouge&quot;&gt;twin events&lt;/code&gt;, where the temperature of a twin exceeded a certain threshold:&lt;/p&gt;
-
-&lt;div class=&quot;highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;{
-  &quot;address&quot;: &quot;POST:/trigger/&amp;lt;your-event-name&amp;gt;/with/key/&amp;lt;your-key&amp;gt;&quot;,
-  &quot;topics&quot;: [
-    &quot;_/_/things/twin/events?filter=gt(features/temperature/properties/value,25)&quot;
-  ],
-  ...
-}
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Get creative on which HTTP APIs to trigger based on twin events. E.g. invoke a “function-as-a-service” API or invoke the 
-Twitter API and let your digital twin tweet whenever it detects, that it is getting too warm in your office.&lt;/p&gt;
-
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Thu, 17 Oct 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-10-17-http-connectivity.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-10-17-http-connectivity.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Ditto Milestone 1.0.0-M1a</title>
-            <description>&lt;p&gt;Today the Ditto team is happy to announce the first milestone of the upcoming release 
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0&quot;&gt;1.0.0&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;Have a look at the Milestone &lt;a href=&quot;release_notes_100-M1a.html&quot;&gt;1.0.0-M1a release notes&lt;/a&gt; for what changed in detail.&lt;/p&gt;
-
-&lt;p&gt;The main changes and new features since the last release &lt;a href=&quot;release_notes_090.html&quot;&gt;0.9.0&lt;/a&gt; are&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;initial contribution of Java client SDK&lt;/li&gt;
-  &lt;li&gt;configurable OpenID Connect authorization servers&lt;/li&gt;
-  &lt;li&gt;fine grained access for connections&lt;/li&gt;
-  &lt;li&gt;scalable event publishing&lt;/li&gt;
-  &lt;li&gt;typed entity IDs&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Tue, 17 Sep 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-09-17-milestone-announcement-100-M1a.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-09-17-milestone-announcement-100-M1a.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Eclipse Ditto now supports OpenID Connect</title>
-            <description>&lt;p&gt;Eclipse Ditto now supports all OAuth 2.0 providers which implement &lt;a href=&quot;https://openid.net/connect/&quot;&gt;OpenID Connect&lt;/a&gt; out-of-the-box.
-You can find a list of certified providers at &lt;a href=&quot;https://openid.net/developers/certified/&quot;&gt;OpenID Connect - Certified OpenID Provider Servers and Services&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;With this post, we want to give an example of this new feature using the open source provider &lt;a href=&quot;https://www.ory.sh&quot;&gt;ORY Hydra&lt;/a&gt;.
-Follow their &lt;a href=&quot;https://www.ory.sh/docs/next/hydra/configure-deploy#installing-ory-hydra&quot;&gt;installation guide&lt;/a&gt; for a
- docker based setup on your development machine.&lt;/p&gt;
-
-&lt;h4 id=&quot;configuration&quot;&gt;Configuration&lt;/h4&gt;
-&lt;p&gt;Download the self-signed certificate form the ORY Hydra server: https://localhost:9000/.well-known/openid-configuration&lt;/p&gt;
-
-&lt;p&gt;Use the downloaded certificate for the akka-http ssl configuration.&lt;/p&gt;
-&lt;pre&gt;&lt;code class=&quot;language-hocon&quot;&gt;ssl-config {
-  trustManager = {
-    stores = [
-      { type = &quot;PEM&quot;, path = &quot;/path/to/cert/globalsign.crt&quot; }
-    ]
-  }
-}
-&lt;/code&gt;&lt;/pre&gt;
-
-&lt;p&gt;The authentication provider must be added to the ditto-gateway configuration.&lt;/p&gt;
-&lt;pre&gt;&lt;code class=&quot;language-hocon&quot;&gt;ditto.gateway.authentication {
-    oauth {
-      openid-connect-issuers = {
-        ory = &quot;https://localhost:9000/&quot;
-      }
-    }
-}
-&lt;/code&gt;&lt;/pre&gt;
-
-&lt;p&gt;The configured subject-issuer will be used to prefix the value of the “sub” claim, e.g.&lt;/p&gt;
-&lt;div class=&quot;language-json highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;subjects&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;ory:foo@bar.com&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;{&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;type&quot;&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;w&quot;&gt; &lt;/span&gt;&lt;span class=&quot;s2&quot;&gt;&quot;generated&quot;&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-    &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-  &lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;span class=&quot;p&quot;&gt;}&lt;/span&gt;&lt;span class=&quot;w&quot;&gt;
-&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;h4 id=&quot;authenticate-ditto-api&quot;&gt;Authenticate Ditto API&lt;/h4&gt;
-&lt;p&gt;Create an OAuth client with hydra to be able to create ID Tokens.&lt;/p&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;docker run &lt;span class=&quot;nt&quot;&gt;--rm&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-it&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;-e&lt;/span&gt; &lt;span class=&quot;nv&quot;&gt;HYDRA_ADMIN_URL&lt;/span&gt;&lt;span class=&quot;o&quot;&gt;=&lt;/span&gt;https://ory-hydra-example--hydra:4445 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;--network&lt;/span&gt; hydraguide &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  oryd/hydra:v1.0.0 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  clients create &lt;span class=&quot;nt&quot;&gt;--skip-tls-verify&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--id&lt;/span&gt; eclipse-ditto &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--secret&lt;/span&gt; some-secret &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--grant-types&lt;/span&gt; authorization_code,refresh_token,client_credentials,implicit &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--response-types&lt;/span&gt; token,code,id_token &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--scope&lt;/span&gt; openid,offline &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--callbacks&lt;/span&gt; http://127.0.0.1:9010/callback
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;Use the client to generate an ID Token.&lt;/p&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;docker run &lt;span class=&quot;nt&quot;&gt;--rm&lt;/span&gt; &lt;span class=&quot;nt&quot;&gt;-it&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;--network&lt;/span&gt; hydraguide &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;-p&lt;/span&gt; 9010:9010 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  oryd/hydra:v1.0.0 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  token user &lt;span class=&quot;nt&quot;&gt;--skip-tls-verify&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--port&lt;/span&gt; 9010 &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--auth-url&lt;/span&gt; https://localhost:9000/oauth2/auth &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--token-url&lt;/span&gt; https://ory-hydra-example--hydra:4444/oauth2/token &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--client-id&lt;/span&gt; eclipse-ditto &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--client-secret&lt;/span&gt; some-secret &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-    &lt;span class=&quot;nt&quot;&gt;--scope&lt;/span&gt; openid
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-&lt;p&gt;After that perform the OAuth 2.0 Authorize Code Flow by opening the link, as prompted, 
-in your browser, and follow the steps shown there.&lt;/p&gt;
-
-&lt;p&gt;Use the generated token to authenticate Ditto API.&lt;/p&gt;
-&lt;div class=&quot;language-bash highlighter-rouge&quot;&gt;&lt;div class=&quot;highlight&quot;&gt;&lt;pre class=&quot;highlight&quot;&gt;&lt;code&gt;curl &lt;span class=&quot;nt&quot;&gt;-X&lt;/span&gt; POST &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  http://localhost:8080/api/2/things &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Authorization: Bearer &amp;lt;JWT&amp;gt;'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;-H&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'Content-Type: application/json'&lt;/span&gt; &lt;span class=&quot;se&quot;&gt;\&lt;/span&gt;
-  &lt;span class=&quot;nt&quot;&gt;-d&lt;/span&gt; &lt;span class=&quot;s1&quot;&gt;'{}'&lt;/span&gt;
-&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/div&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Wed, 28 Aug 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-08-28-openid-connect.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-08-28-openid-connect.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Eclipse Ditto Release 0.9.0</title>
-            <description>&lt;p&gt;Today the Eclipse Ditto team proudly presents its second release 
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/0.9.0&quot;&gt;0.9.0&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The topics of this release in a nutshell were:&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;Memory improvements for huge amounts (multi million) of digital twins which are held in memory&lt;/li&gt;
-  &lt;li&gt;Adding metrics and logging around the connectivity feature in order to enable being able to operate connections to foreign systems/brokers via APIs&lt;/li&gt;
-  &lt;li&gt;Enhancing Ditto’s connectivity feature by additionally being able to connect to Apache Kafka&lt;/li&gt;
-  &lt;li&gt;Performance improvements of Ditto’s search functionality&lt;/li&gt;
-  &lt;li&gt;Stabilization of cluster bootstrapping&lt;/li&gt;
-  &lt;li&gt;Refactoring of how the services configurations are determined&lt;/li&gt;
-  &lt;li&gt;Addition of a Helm template in order to simplify Kubernetes based deployments&lt;/li&gt;
-  &lt;li&gt;Contributions from Microsoft in order to ease operating Eclipse Ditto on Microsoft Azure&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;Please have a look at the &lt;a href=&quot;release_notes_090.html&quot;&gt;0.9.0 release notes&lt;/a&gt; for a more detailed information on the release.&lt;/p&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Wed, 10 Jul 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-07-10-release-announcement-090.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-07-10-release-announcement-090.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Ditto Milestone 0.9.0-M2</title>
-            <description>&lt;p&gt;The second milestone of the upcoming release 
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/0.9.0&quot;&gt;0.9.0&lt;/a&gt; was released today.&lt;/p&gt;
-
-&lt;p&gt;Have a look at the Milestone &lt;a href=&quot;release_notes_090-M2.html&quot;&gt;0.9.0-M2 release notes&lt;/a&gt; for what changed in detail.&lt;/p&gt;
-
-&lt;p&gt;The main changes and new features since the last milestone &lt;a href=&quot;release_notes_090-M1.html&quot;&gt;0.9.0-M1&lt;/a&gt; are&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;rewrite of Ditto’s “search” service in order to use the same index and have the same query performance for API v1 and v2&lt;/li&gt;
-  &lt;li&gt;several contributions in order to operate Eclipse Ditto on Microsoft Azure&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Mon, 29 Apr 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-04-29-milestone-announcement-090-M2.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-04-29-milestone-announcement-090-M2.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-        <item>
-            <title>Announcing Ditto Milestone 0.9.0-M1</title>
-            <description>&lt;p&gt;Today the Ditto team is happy to announce the first milestone of the upcoming release 
-&lt;a href=&quot;https://projects.eclipse.org/projects/iot.ditto/releases/0.9.0&quot;&gt;0.9.0&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;Have a look at the Milestone &lt;a href=&quot;release_notes_090-M1.html&quot;&gt;0.9.0-M1 release notes&lt;/a&gt; for what changed in detail.&lt;/p&gt;
-
-&lt;p&gt;The main changes and new features since the last release &lt;a href=&quot;release_notes_080.html&quot;&gt;0.8.0&lt;/a&gt; are&lt;/p&gt;
-
-&lt;ul&gt;
-  &lt;li&gt;memory optimizations when working with millions of digital twins&lt;/li&gt;
-  &lt;li&gt;enhance connectivity to also be able to establish connections to Apache Kafka&lt;/li&gt;
-  &lt;li&gt;providing more detailed metrics for connections&lt;/li&gt;
-  &lt;li&gt;cluster bootstrapping stability improvements&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;h2 id=&quot;artifacts&quot;&gt;Artifacts&lt;/h2&gt;
-
-&lt;p&gt;The new Java artifacts have been published at the &lt;a href=&quot;https://repo.eclipse.org/content/repositories/ditto/&quot;&gt;Eclipse Maven repository&lt;/a&gt;
-as well as &lt;a href=&quot;https://repo1.maven.org/maven2/org/eclipse/ditto/&quot;&gt;Maven central&lt;/a&gt;.&lt;/p&gt;
-
-&lt;p&gt;The Docker images have been pushed to Docker Hub:&lt;/p&gt;
-&lt;ul&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-policies/&quot;&gt;eclipse/ditto-policies&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things/&quot;&gt;eclipse/ditto-things&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-things-search/&quot;&gt;eclipse/ditto-things-search&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-gateway/&quot;&gt;eclipse/ditto-gateway&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-connectivity/&quot;&gt;eclipse/ditto-connectivity&lt;/a&gt;&lt;/li&gt;
-  &lt;li&gt;&lt;a href=&quot;https://hub.docker.com/r/eclipse/ditto-concierge/&quot;&gt;eclipse/ditto-concierge&lt;/a&gt;&lt;/li&gt;
-&lt;/ul&gt;
-
-&lt;p&gt;&lt;br /&gt;
-&lt;br /&gt;&lt;/p&gt;
-&lt;figure&gt;&lt;img class=&quot;docimage&quot; src=&quot;images/ditto.svg&quot; alt=&quot;Ditto&quot; style=&quot;max-width: 500px&quot; /&gt;&lt;/figure&gt;
-
-&lt;p&gt;–&lt;br /&gt;
-The Eclipse Ditto team&lt;/p&gt;
-</description>
-            <pubDate>Thu, 28 Mar 2019 00:00:00 +0000</pubDate>
-            <link>https://www.eclipse.org/ditto/2019-03-28-milestone-announcement-090-M1.html</link>
-            <guid isPermaLink="true">https://www.eclipse.org/ditto/2019-03-28-milestone-announcement-090-M1.html</guid>
-            
-            <category>blog</category>
-            
-            
-        </item>
-        
-    </channel>
-</rss>
diff --git a/1.1/sitemap.xml b/1.1/sitemap.xml
deleted file mode 100644
index 7b9ce2f..0000000
--- a/1.1/sitemap.xml
+++ /dev/null
@@ -1,915 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2020-04-29-release-announcement-110.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2020-04-16-connecting-to-ttn-via-mqtt.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-12-12-release-announcement-100.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-11-04-milestone-announcement-100-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-10-17-http-connectivity.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-09-17-milestone-announcement-100-M1a.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-08-28-openid-connect.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-07-10-release-announcement-090.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-04-29-milestone-announcement-090-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-03-28-milestone-announcement-090-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2019-03-13-kafka-connectivity.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-12-05-example-command-and-control.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-11-28-release-announcement-080.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-11-14-milestone-announcement-080-M3.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-10-16-example-mqtt-bidirectional.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-09-27-milestone-announcement-080-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-09-21-selective-push-notifications.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-08-14-milestone-announcement-080-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-06-15-milestone-announcement-030-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-05-02-connecting-ditto-hono.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-04-26-milestone-announcement-030-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-04-25-connectivity-service.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-02-08-feature-definition.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-02-07-milestone-announcement-020-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-01-15-example-demonstrating-rest-to-websocket.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2018-01-12-milestone-announcement-010-M3.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2017-12-18-milestone-announcement-010-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/2017-11-10-welcome-to-ditto.html</loc>
-  </url>
-  
-  
-
-
-  
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-concierge.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-connectivity.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-gateway.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-policies.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-things-search.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/architecture-services-things.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-acknowledgements.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-acl.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-apis.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-auth.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-changenotifications.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-connections.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-enrichment.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-feature.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-messages.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-namespaces-and-names.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-placeholders.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-policy.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-rql.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-search.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-signals-command.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-signals-commandresponse.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-signals-errorresponse.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-signals-event.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-signals.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/basic-thing.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/blog.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/blog_archive.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/client-sdk-java.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/client-sdk-javascript.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/client-sdk-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-header-mapping.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-manage-connections.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-mapping.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-amqp091.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-amqp10.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-http.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-kafka2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-mqtt.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-mqtt5.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/connectivity-tls-certificates.html</loc>
-  </url>
-  
-  
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/feedback.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/glossary.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/http-api-doc.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-concepts.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-messages.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-protocol-bindings-websocket.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-search.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/httpapi-sse.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/index.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/installation-building.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/installation-operating.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/installation-running.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/intro-digitaltwins.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/intro-hello-world.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/intro-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/presentations.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-bindings.html</loc>
-  </url>
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-examples.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-overview.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-acks.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-policies-create-or-modify.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-policies-delete.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-policies-retrieve.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-policies.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things-create-or-modify.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things-delete.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things-messages.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things-retrieve.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things-search.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-things.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification-topic.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-specification.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/protocol-twinlive.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_010-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_010-M3.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_020-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_030-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_030-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_080.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_080-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_080-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_080-M3.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_090.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_090-M1.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_090-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_100.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_100-M1a.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_100-M2.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/release_notes_110.html</loc>
-  </url>
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/sandbox.html</loc>
-  </url>
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  
-  <url>
-    <loc>https://www.eclipse.org/ditto/robots.txt</loc>
-  </url>
-  
-  
-</urlset>
\ No newline at end of file
diff --git a/404.html b/404.html
index 2a39bf9..1c4c861 100644
--- a/404.html
+++ b/404.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/architecture-overview.html b/architecture-overview.html
index db201ef..1edbc06 100644
--- a/architecture-overview.html
+++ b/architecture-overview.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/architecture-services-concierge.html b/architecture-services-concierge.html
index 145f06a..b2db298 100644
--- a/architecture-services-concierge.html
+++ b/architecture-services-concierge.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/architecture-services-connectivity.html b/architecture-services-connectivity.html
index 8c664cb..cdc9013 100644
--- a/architecture-services-connectivity.html
+++ b/architecture-services-connectivity.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/architecture-services-gateway.html b/architecture-services-gateway.html
index 88df4c5..6113eba 100644
--- a/architecture-services-gateway.html
+++ b/architecture-services-gateway.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/architecture-services-policies.html b/architecture-services-policies.html
index 655b4e0..01092fd 100644
--- a/architecture-services-policies.html
+++ b/architecture-services-policies.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/architecture-services-things-search.html b/architecture-services-things-search.html
index 71d9e20..c038b25 100644
--- a/architecture-services-things-search.html
+++ b/architecture-services-things-search.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/architecture-services-things.html b/architecture-services-things.html
index 3f985f5..7288f0e 100644
--- a/architecture-services-things.html
+++ b/architecture-services-things.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/architecture/DADR-0001-record-architecture-decisions.md b/architecture/DADR-0001-record-architecture-decisions.md
deleted file mode 100644
index f861c36..0000000
--- a/architecture/DADR-0001-record-architecture-decisions.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# Record architecture decisions
-
-Date: 14.08.2019
-
-## Status
-
-accepted
-
-## Context
-
-We want to record architectural decisions made on the Ditto project to keep track of the motivation behind certain decisions.
-
-## Decision
-
-We will use Architecture Decision Records, as described by Michael Nygard in this 
-[article](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions) and also use the proposed
- [template](https://github.com/joelparkerhenderson/architecture_decision_record/blob/master/adr_template_by_michael_nygard.md).
-
-## Consequences
-
-From Michael Nygard's article (link above): 
-> The motivation behind previous decisions is visible for everyone, present and future. Nobody is left scratching
-> their heads to understand, "What were they thinking?" and the time to change old decisions will be clear from changes 
-> in the project's context.
\ No newline at end of file
diff --git a/architecture/DADR-0002-replace-akka-pubsub-for-event-publishing.md b/architecture/DADR-0002-replace-akka-pubsub-for-event-publishing.md
deleted file mode 100644
index ca5302c..0000000
--- a/architecture/DADR-0002-replace-akka-pubsub-for-event-publishing.md
+++ /dev/null
@@ -1,43 +0,0 @@
-# Record architecture decisions
-
-Date: 23.08.2019
-
-## Status
-
-accepted
-
-## Context
-
-Up to now Ditto used Akka's distributed publish/subscribe in order to emit e.g. `ThingEvent`s to interested other services:
-
-* gateway
-    * websocket/SSE sessions publishing events
-* connectivity
-    * AMQP 1.0 / AMQP 0.9.1 / MQTT / Kafka sessions publishing events
-* things-search
-    * ThingUpdater updating the search index
-
-That naive approach works, but does not provide *horizontal scalability*:
-
-* each single service instance generally interested in `ThingEvent`s gets all of them, regardless of whether someone is actually interested in them
-* as a result a lot of avoidable JSON deserialization is done
-* when Ditto needs to scale the event publishing horizontally, adding new gateway or connectivity instances will not help scaling the event publishing
-    * still all instances will have to process each `ThingEvent` and discard if not relevant
-
-## Decision
-
-We will implement a custom Ditto pub/sub which
-
-* uses "authorization subjects" as topics when subscribing
-* uses "read subjects" as topics when publishing
-* manages and distributes the active subscriptions via Akka Distributed Data (ddata)
-* emits `ThingEvent`s only to service instances where at least one consumer consumes the event
-
-## Consequences
-
-The event publishing is no longer implemented by a proven and stable Akka feature but lies in our own
-responsibility. This has upsides (we can implement it just the way we need it) as well as downsides 
-(we might add bugs which were not).
-
-The consequence for horizontal scalability is that the event publishing should as well - like the rest of Ditto - be 
-horizontally scalable.
\ No newline at end of file
diff --git a/architecture/DADR-0003-do-not-interrupt-threads.md b/architecture/DADR-0003-do-not-interrupt-threads.md
deleted file mode 100644
index f1f3ded..0000000
--- a/architecture/DADR-0003-do-not-interrupt-threads.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# Do not interrupt threads
-
-Date: 29.08.2019
-
-## Status
-
-accepted
-
-## Context
-
-SonarQube [RSPEC-2142](https://rules.sonarsource.com/java/tag/multi-threading/RSPEC-2142) complains when we catch
-`InterruptedException` and not call `Thread.currentThread().interrupt()` in the catch block.
-
-Simply calling `Thread.currentThread().interrupt()` to silence SonarQube is dangerous. Due to the way JUnit reuses
-threads, a call to `Thread.interrupt()` breaks the build in unpredictable ways, several tests after the actual site of
-interruption.
-
-## Decision
-
-We will ignore [RSPEC-2142](https://rules.sonarsource.com/java/tag/multi-threading/RSPEC-2142).
-
-## Consequences
-
-The best way to deal with `InterruptedException` is not catching it at all.
-Leave it to Akka to handle low-level concurrency errors.
-Use Akka's `CompletionStage` APIs instead of blocking-wait whenever possible.
-Use `CompletableFuture.join()` instead of `CompletableFuture.get()` in tests.
-
-Where blocking-wait cannot be avoided, the actors executing blocking wait should execute in their own dispatcher
-to not starve the actor system of threads. Use
-[PinnedDispatcher](https://doc.akka.io/docs/akka/current/dispatchers.html)
-for example to give each blocking actor its own thread.
diff --git a/architecture/DADR-0004-signal-enrichment.md b/architecture/DADR-0004-signal-enrichment.md
deleted file mode 100644
index f8b305d..0000000
--- a/architecture/DADR-0004-signal-enrichment.md
+++ /dev/null
@@ -1,66 +0,0 @@
-# Signal enrichment via "extraFields"
-
-Date: 20.01.2020
-
-## Status
-
-accepted
-
-## Context
-
-Supporting a new feature, the so called [signal enrichment](https://github.com/eclipse/ditto/issues/561), raises a few
-questions towards throughput and scalability impact of that new feature.
-
-In the current architecture, Ditto internally publishes events (as part of the applied "event sourcing" pattern) for 
-each change which was done to a `Thing`. This event is the same as the persisted one only containing the actually 
-changed fields. 
-
-The "signal enrichment" feature shall support defining `extraFields` to be sent out to external event subscribers, e.g.
-being notified about changes via WebSocket, Server Sent Events (SSEs) or connections (AMQP, MQTT, Kafka, ...).
-
-The following alternatives were considered on how to implement that feature:
-
-1. Sending along the complete `Thing` state in each event in the cluster
-    * upside: "tell, don't ask" principle -> would lead to a minimum of required cluster remoting / roundtrips
-    * downside: bigger payload sent around
-    * downside: a lot of deserialization effort for all event consuming services
-    * downside: policy filtering would have to be additionally done somewhere only included data which the `authSubject` is allowed to READ
-    * downside: overall a lot of overhead for probably only few consumers
-2. Enriching the data for sessions/connections which selected `extraFields` for each incoming event
-    * upside: no additional payload for existing events
-    * upside: data is only enriched for sessions/connections really using that feature
-    * upside: policy enforcement/filtering is done by default concierge mechanism for each single request, so is always up-to-date with policy
-    * downside: additional 4 remoting (e.g.: gateway-concierge-things-concierge-gateway) calls for each to be enriched event
-         * delayed event publishing
-         * additional deserialization efforts 
-         * potentially asking for the same static values each time
-3. Cache based enriching of the data for sessions/connections which selected `extraFields` for each incoming event
-    * upsides: all upsides of approach 2 except that policy is always up-to-date
-    * upside: mitigating downsides of approach 2 (because of cache the additional roundtrips are reduced or even completely skipped)
-    * downside: cached data as well as policy information might be outdated a configurable amount of time (e.g. 2 minutes)
-    
-    
-## Decision
-
-We provide 2 different facade implementations providing approach 2 and 3:
-* `org.eclipse.ditto.services.models.signalenrichment.ByRoundTripSignalEnrichmentFacade`: 
-    Round-trip for each to-be-enriched event resulting in a guaranteed up-to-dateness of data and applied policy.
-* `org.eclipse.ditto.services.models.signalenrichment.CachingSignalEnrichmentFacade`: 
-    Using cache for each to-be-enriched event resulting in reduced remoting effort and a time interval where the cache might be out of sync with the current data or policy information.
-    * the implementation uses a cluster-instance wide cache using a cache key consisting of: `thingId, authSubjects, jsonFieldSelector`
-    * the overall size of this cache is configured, by default to `20,000` entries
-    * there is an additional "smart-update" mechanism for cache entries related to enrichment of twin events:
-      in the absence of skipped events, the cache entry can be completely deduced from the twin events triggering
-      enrichment and will stay up-to-date with thing changes (but not with policy changes).
-
-The configured default in Ditto is the `CachingSignalEnrichmentFacade` but may be configured via
-* connectivity service: environment variable `CONNECTIVITY_SIGNAL_ENRICHMENT_PROVIDER`
-* gateway service: environment variable `GATEWAY_SIGNAL_ENRICHMENT_PROVIDER`
-
-## Consequences
-
-When operating Ditto, one has to choose what is more important:
-* guaranteed correctness of the enriched data
-* reasonable clustering costs for enriching data
-
-When using the cache based implementation, the users might experience unexpected enriched "extra fields".
diff --git a/architecture/DADR-0005-semantic-versioning.md b/architecture/DADR-0005-semantic-versioning.md
deleted file mode 100644
index 9ff89bb..0000000
--- a/architecture/DADR-0005-semantic-versioning.md
+++ /dev/null
@@ -1,103 +0,0 @@
-# Semantic versioning
-
-Date: 27.01.2020
-
-Enhancement of adding `@since` in javadoc: 21.02.2020
-
-## Status
-
-accepted
-
-## Context
-
-Eclipse Ditto project exited the incubation phase with release 1.0.0.
-Henceforth any change to the Ditto API enters a Ditto release according to [semantic versioning](https://semver.org):
-- Incompatible API changes increment major version number (e. g., 1.7.5 -> 2.0.0);
-- Compatible API changes increment minor version number (e. g., 1.2.3 -> 1.3.0);
-- Changes in the implementation without any API change increment patch version number (e. g., 1.0.0 -> 1.0.1).
-
-This document defines what _API compatibility_ means,
-the modules which are considered API and for which semantic versioning holds,
-and the enforcement of semantic versioning.
-
-## Decision
-
-### API compatibility
-
-For Eclipse Ditto, API compatibility means _binary compatibility_ defined by
-the [Java Language Specification, Java SE 8 Edition, chapter 13](https://docs.oracle.com/javase/specs/jls/se8/html/jls-13.html).
-Examples of binary-compatible changes:
-- Adding a top-level interface or class.
-- Making a non-public interface or class public.
-- Adding classes to a class's set of superclasses without introducing circular inheritance.
-- Adding type parameters without changing the signature of existing methods.
-- Renaming type parameters.
-- Deleting private members.
-- Adding enums.
-- Adding abstract methods to interfaces.
-- Adding members to a class that do not collide with any other member in all its subclasses in Ditto.
-- Adding default methods to an interface that do not collide with any other method in all subclasses of the interface
-  in Ditto.
-
-Binary compatibility guarantees that any user code of Ditto does not break on minor version upgrades, provided that
-- the user code does not implement Ditto interfaces, and
-- the user code does not extend Ditto classes.
-
-Inheritance from Ditto classes and interfaces is excluded from API compatibility because Ditto interfaces are often
-defined to hide implementation details from user code. Compatibility for user-defined subclasses, or source
-compatibility, is not a part of Ditto's semantic versioning. Inheriting user classes may break after a minor Ditto
-version upgrade.
-
-### Modules considered API
-
-Public classes, interfaces and their public members of the following modules and their submodules are considered
-Ditto API. Changes to them must enter Ditto release in accord with semantic versioning.
-Modules not on this list are not considered API; they may contain incompatible changes for any Ditto version change.
-
-```
-ditto-json
-ditto-model
-ditto-protocol-adapter
-ditto-signals
-ditto-utils
-```
-
-### Javadoc documentation using `@since`
-
-When adding new public visible API (e.g. new interfaces, classes or methods in existing code) in the defined API modules, a `@since <version>` javadoc annotation shall be added.
-
-Example:
-```java
-/**
- * Returns the extra information which enriches the actual value of this change.
- * 
- * @return the extra data or an empty Optional.
- * @since 1.1.0
- */
-Optional<JsonObject> getExtra();
-```
-
-Existing public API without `@since` can be interpreted as `@since 1.0.0` and can be added when adjusting a class.
-
-### Enforcement of semantic versioning
-
-Semantic versioning is enforced through binary compatibility check by `japicmp-maven-plugin`.
-```xml
-<plugin>
-  <groupId>com.github.siom79.japicmp</groupId>
-  <artifactId>japicmp-maven-plugin</artifactId>
-</plugin>
-```
-Deviations of the behavior of `japicmp-maven-plugin` from binary compatibility defined by the Java language
-specification are to be corrected through overrides. If `japicmp-maven-plugin` breaks the build for a branch,
-then a major version increment for the next release is required to merge the branch into Ditto master.
-Check with the whole Ditto team before adding anything to the exclusion list of `japicmp-maven-plugin`.
-
-## Consequences
-
-User code of modules considered API does not break on minor Ditto version upgrade if it does not inherit from Ditto
-classes or interfaces.
-
-User code of modules considered API does not break on patch Ditto version upgrade.
-
-User code of other modules may break on any Ditto version change.
diff --git a/basic-acknowledgements.html b/basic-acknowledgements.html
index cb3ea8f..c4c45ff 100644
--- a/basic-acknowledgements.html
+++ b/basic-acknowledgements.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-acl.html b/basic-acl.html
index 6e550d4..3df8771 100644
--- a/basic-acl.html
+++ b/basic-acl.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-apis.html b/basic-apis.html
index 248da42..57c0a04 100644
--- a/basic-apis.html
+++ b/basic-apis.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-auth.html b/basic-auth.html
index cbe4370..d62084f 100644
--- a/basic-auth.html
+++ b/basic-auth.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-changenotifications.html b/basic-changenotifications.html
index 1178bc8..58a2ce2 100644
--- a/basic-changenotifications.html
+++ b/basic-changenotifications.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-connections.html b/basic-connections.html
index 19c29e5..254516b 100644
--- a/basic-connections.html
+++ b/basic-connections.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-enrichment.html b/basic-enrichment.html
index d560e89..5608784 100644
--- a/basic-enrichment.html
+++ b/basic-enrichment.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-feature.html b/basic-feature.html
index 5d3e051..695b264 100644
--- a/basic-feature.html
+++ b/basic-feature.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-messages.html b/basic-messages.html
index 9313d2a..c8860cd 100644
--- a/basic-messages.html
+++ b/basic-messages.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-namespaces-and-names.html b/basic-namespaces-and-names.html
index 8762685..bdbaf7f 100644
--- a/basic-namespaces-and-names.html
+++ b/basic-namespaces-and-names.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-overview.html b/basic-overview.html
index cef442c..f2553f6 100644
--- a/basic-overview.html
+++ b/basic-overview.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-placeholders.html b/basic-placeholders.html
index 73a4851..0088d29 100644
--- a/basic-placeholders.html
+++ b/basic-placeholders.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-policy.html b/basic-policy.html
index 646c6c9..7eae147 100644
--- a/basic-policy.html
+++ b/basic-policy.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-rql.html b/basic-rql.html
index 263ae6e..e7b2861 100644
--- a/basic-rql.html
+++ b/basic-rql.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-search.html b/basic-search.html
index 3b09b70..b1b330b 100644
--- a/basic-search.html
+++ b/basic-search.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-signals-command.html b/basic-signals-command.html
index 5a51d42..1d16c26 100644
--- a/basic-signals-command.html
+++ b/basic-signals-command.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-signals-commandresponse.html b/basic-signals-commandresponse.html
index 4c52f55..a3686ac 100644
--- a/basic-signals-commandresponse.html
+++ b/basic-signals-commandresponse.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-signals-errorresponse.html b/basic-signals-errorresponse.html
index e391c5e..66a087f 100644
--- a/basic-signals-errorresponse.html
+++ b/basic-signals-errorresponse.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-signals-event.html b/basic-signals-event.html
index 9245de7..930e1d5 100644
--- a/basic-signals-event.html
+++ b/basic-signals-event.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-signals.html b/basic-signals.html
index 1571753..cedd95b 100644
--- a/basic-signals.html
+++ b/basic-signals.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/basic-thing.html b/basic-thing.html
index 3ede417..be0306c 100644
--- a/basic-thing.html
+++ b/basic-thing.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/client-sdk-java.html b/client-sdk-java.html
index 034e9f6..70109c0 100644
--- a/client-sdk-java.html
+++ b/client-sdk-java.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/client-sdk-javascript.html b/client-sdk-javascript.html
index b9e2e35..91a997e 100644
--- a/client-sdk-javascript.html
+++ b/client-sdk-javascript.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/client-sdk-overview.html b/client-sdk-overview.html
index 52269ce..fbfb650 100644
--- a/client-sdk-overview.html
+++ b/client-sdk-overview.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-header-mapping.html b/connectivity-header-mapping.html
index 682d302..db42085 100644
--- a/connectivity-header-mapping.html
+++ b/connectivity-header-mapping.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-manage-connections.html b/connectivity-manage-connections.html
index a67a219..5b19054 100644
--- a/connectivity-manage-connections.html
+++ b/connectivity-manage-connections.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-mapping.html b/connectivity-mapping.html
index d54c717..1427c81 100644
--- a/connectivity-mapping.html
+++ b/connectivity-mapping.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-overview.html b/connectivity-overview.html
index cb51198..7d94f1e 100644
--- a/connectivity-overview.html
+++ b/connectivity-overview.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-protocol-bindings-amqp091.html b/connectivity-protocol-bindings-amqp091.html
index 626b55c..d57cf32 100644
--- a/connectivity-protocol-bindings-amqp091.html
+++ b/connectivity-protocol-bindings-amqp091.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-protocol-bindings-amqp10.html b/connectivity-protocol-bindings-amqp10.html
index 7b13323..fe8fdbd 100644
--- a/connectivity-protocol-bindings-amqp10.html
+++ b/connectivity-protocol-bindings-amqp10.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-protocol-bindings-http.html b/connectivity-protocol-bindings-http.html
index b91c62e..9f5d264 100644
--- a/connectivity-protocol-bindings-http.html
+++ b/connectivity-protocol-bindings-http.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-protocol-bindings-kafka2.html b/connectivity-protocol-bindings-kafka2.html
index 79b6f78..2c1957b 100644
--- a/connectivity-protocol-bindings-kafka2.html
+++ b/connectivity-protocol-bindings-kafka2.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-protocol-bindings-mqtt.html b/connectivity-protocol-bindings-mqtt.html
index ee44b8c..7d23049 100644
--- a/connectivity-protocol-bindings-mqtt.html
+++ b/connectivity-protocol-bindings-mqtt.html
@@ -715,6 +715,11 @@
               
               
               
+              <li class="active"><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-protocol-bindings-mqtt5.html b/connectivity-protocol-bindings-mqtt5.html
index 39ea726..6ead3bd 100644
--- a/connectivity-protocol-bindings-mqtt5.html
+++ b/connectivity-protocol-bindings-mqtt5.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li class="active"><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/connectivity-tls-certificates.html b/connectivity-tls-certificates.html
index fd4b060..23d37e8 100644
--- a/connectivity-tls-certificates.html
+++ b/connectivity-tls-certificates.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/feed.xml b/feed.xml
index dd3b062..c958832 100644
--- a/feed.xml
+++ b/feed.xml
@@ -5,8 +5,8 @@
         <description>Announcements, tutorials and examples around Eclipse Ditto and Digital Twins</description>
         <link>https://www.eclipse.org/ditto/</link>
         <atom:link href="https://www.eclipse.org/ditto/feed.xml" rel="self" type="application/rss+xml"/>
-        <pubDate>Wed, 29 Apr 2020 09:04:19 +0000</pubDate>
-        <lastBuildDate>Wed, 29 Apr 2020 09:04:19 +0000</lastBuildDate>
+        <pubDate>Wed, 29 Apr 2020 10:46:31 +0000</pubDate>
+        <lastBuildDate>Wed, 29 Apr 2020 10:46:31 +0000</lastBuildDate>
         <generator>Jekyll v3.6.2</generator>
         
         <item>
diff --git a/feedback.html b/feedback.html
index 083e575..1365221 100644
--- a/feedback.html
+++ b/feedback.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/glossary.html b/glossary.html
index 39d5e6b..a5d6a3d 100644
--- a/glossary.html
+++ b/glossary.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/httpapi-concepts.html b/httpapi-concepts.html
index dd16ad8..536d040 100644
--- a/httpapi-concepts.html
+++ b/httpapi-concepts.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/httpapi-messages.html b/httpapi-messages.html
index 8ba1219..54bd5ca 100644
--- a/httpapi-messages.html
+++ b/httpapi-messages.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/httpapi-overview.html b/httpapi-overview.html
index f877a16..5b11a61 100644
--- a/httpapi-overview.html
+++ b/httpapi-overview.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/httpapi-protocol-bindings-websocket.html b/httpapi-protocol-bindings-websocket.html
index fb9963b..b50fbbf 100644
--- a/httpapi-protocol-bindings-websocket.html
+++ b/httpapi-protocol-bindings-websocket.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/httpapi-search.html b/httpapi-search.html
index ef25ad2..1bfe152 100644
--- a/httpapi-search.html
+++ b/httpapi-search.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/httpapi-sse.html b/httpapi-sse.html
index 03ff488..1342868 100644
--- a/httpapi-sse.html
+++ b/httpapi-sse.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/installation-building.html b/installation-building.html
index 31e68e3..1f24960 100644
--- a/installation-building.html
+++ b/installation-building.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/installation-operating.html b/installation-operating.html
index e1dd4e4..e4bc48c 100644
--- a/installation-operating.html
+++ b/installation-operating.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/installation-running.html b/installation-running.html
index 5054b76..38d478c 100644
--- a/installation-running.html
+++ b/installation-running.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/intro-digitaltwins.html b/intro-digitaltwins.html
index 9ae142e..0b4ded4 100644
--- a/intro-digitaltwins.html
+++ b/intro-digitaltwins.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/intro-hello-world.html b/intro-hello-world.html
index 2794e73..4226ebb 100644
--- a/intro-hello-world.html
+++ b/intro-hello-world.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/intro-overview.html b/intro-overview.html
index d307aa0..19d6299 100644
--- a/intro-overview.html
+++ b/intro-overview.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicy.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicy.md
deleted file mode 100644
index fb8bb46..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicy.md
+++ /dev/null
@@ -1,32 +0,0 @@
-## CreatePolicy
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/create",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "policyId": "com.acme:the_policy_id",
-    "entries": {
-      "the_label": {
-        "subjects": {
-          "google:the_subjectid": {
-            "type": "yourSubjectTypeDescription"
-          }
-        },
-        "resources": {
-          "thing:/the_resource_path": {
-            "grant": [
-              "READ",
-              "WRITE"
-            ],
-            "revoke": []
-          }
-        }
-      }
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicyresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicyresponse.md
deleted file mode 100644
index 78d3dab..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicyresponse.md
+++ /dev/null
@@ -1,33 +0,0 @@
-## CreatePolicyResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/create",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "policyId": "com.acme:the_policy_id",
-    "entries": {
-      "the_label": {
-        "subjects": {
-          "google:the_subjectid": {
-            "type": "yourSubjectTypeDescription"
-          }
-        },
-        "resources": {
-          "thing:/the_resource_path": {
-            "grant": [
-              "READ",
-              "WRITE"
-            ],
-            "revoke": []
-          }
-        }
-      }
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicy.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicy.md
deleted file mode 100644
index 1c0bc9c..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicy.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## DeletePolicy
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/delete",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentry.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentry.md
deleted file mode 100644
index be4cd37..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentry.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## DeletePolicyEntry
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/delete",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentryresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentryresponse.md
deleted file mode 100644
index c40924c..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentryresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## DeletePolicyEntryResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/delete",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyresponse.md
deleted file mode 100644
index c7b0963..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## DeletePolicyResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/delete",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresource.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresource.md
deleted file mode 100644
index 026d9fc..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresource.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## DeleteResource
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/delete",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources/thing:/the_resource_path"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresourceresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresourceresponse.md
deleted file mode 100644
index 6f7af97..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresourceresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## DeleteResourceResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/delete",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources/thing:/the_resource_path",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubject.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubject.md
deleted file mode 100644
index 5e31dbf..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubject.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## DeleteSubject
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/delete",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects/google:the_subjectid"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubjectresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubjectresponse.md
deleted file mode 100644
index bc5f596..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubjectresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## DeleteSubjectResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/delete",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects/google:the_subjectid",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicy.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicy.md
deleted file mode 100644
index e6b248a..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicy.md
+++ /dev/null
@@ -1,32 +0,0 @@
-## ModifyPolicy
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "policyId": "com.acme:the_policy_id",
-    "entries": {
-      "the_label": {
-        "subjects": {
-          "google:the_subjectid": {
-            "type": "yourSubjectTypeDescription"
-          }
-        },
-        "resources": {
-          "thing:/the_resource_path": {
-            "grant": [
-              "READ",
-              "WRITE"
-            ],
-            "revoke": []
-          }
-        }
-      }
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentries.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentries.md
deleted file mode 100644
index 9a4ed6a..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentries.md
+++ /dev/null
@@ -1,51 +0,0 @@
-## ModifyPolicyEntries
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries",
-  "value": {
-    "another_label": {
-      "__schemaVersion": 2,
-      "subjects": {
-        "google:the_subjectid": {
-          "__schemaVersion": 2,
-          "type": "yourSubjectTypeDescription"
-        }
-      },
-      "resources": {
-        "thing:/the_resource_path": {
-          "__schemaVersion": 2,
-          "grant": [
-            "READ",
-            "WRITE"
-          ],
-          "revoke": []
-        }
-      }
-    },
-    "the_label": {
-      "__schemaVersion": 2,
-      "subjects": {
-        "google:the_subjectid": {
-          "__schemaVersion": 2,
-          "type": "yourSubjectTypeDescription"
-        }
-      },
-      "resources": {
-        "thing:/the_resource_path": {
-          "__schemaVersion": 2,
-          "grant": [
-            "READ",
-            "WRITE"
-          ],
-          "revoke": []
-        }
-      }
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentriesresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentriesresponse.md
deleted file mode 100644
index 1f9f36e..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentriesresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## ModifyPolicyEntriesResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentry.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentry.md
deleted file mode 100644
index 062edad..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentry.md
+++ /dev/null
@@ -1,29 +0,0 @@
-## ModifyPolicyEntry
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label",
-  "value": {
-    "subjects": {
-      "google:the_subjectid": {
-        "__schemaVersion": 2,
-        "type": "yourSubjectTypeDescription"
-      }
-    },
-    "resources": {
-      "thing:/the_resource_path": {
-        "__schemaVersion": 2,
-        "grant": [
-          "READ",
-          "WRITE"
-        ],
-        "revoke": []
-      }
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponse.md
deleted file mode 100644
index 1455bd6..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## ModifyPolicyEntryResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponsecreated.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponsecreated.md
deleted file mode 100644
index e17e602..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponsecreated.md
+++ /dev/null
@@ -1,28 +0,0 @@
-## ModifyPolicyEntryResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label",
-  "value": {
-    "subjects": {
-      "google:the_subjectid": {
-        "type": "yourSubjectTypeDescription"
-      }
-    },
-    "resources": {
-      "thing:/the_resource_path": {
-        "grant": [
-          "READ",
-          "WRITE"
-        ],
-        "revoke": []
-      }
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponse.md
deleted file mode 100644
index ca19869..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## ModifyPolicyResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponsecreated.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponsecreated.md
deleted file mode 100644
index b371899..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponsecreated.md
+++ /dev/null
@@ -1,33 +0,0 @@
-## ModifyPolicyResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "policyId": "com.acme:the_policy_id",
-    "entries": {
-      "the_label": {
-        "subjects": {
-          "google:the_subjectid": {
-            "type": "yourSubjectTypeDescription"
-          }
-        },
-        "resources": {
-          "thing:/the_resource_path": {
-            "grant": [
-              "READ",
-              "WRITE"
-            ],
-            "revoke": []
-          }
-        }
-      }
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresource.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresource.md
deleted file mode 100644
index ed5535c..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresource.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## ModifyResource
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources/thing:/the_resource_path",
-  "value": {
-    "grant": [
-      "READ",
-      "WRITE"
-    ],
-    "revoke": []
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponse.md
deleted file mode 100644
index e86d712..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## ModifyResourceResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources/thing:/the_resource_path",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponsecreated.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponsecreated.md
deleted file mode 100644
index 0ee5241..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponsecreated.md
+++ /dev/null
@@ -1,19 +0,0 @@
-## ModifyResourceResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources/thing:/the_resource_path",
-  "value": {
-    "grant": [
-      "READ",
-      "WRITE"
-    ],
-    "revoke": []
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresources.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresources.md
deleted file mode 100644
index 01b393d..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresources.md
+++ /dev/null
@@ -1,21 +0,0 @@
-## ModifyResources
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources",
-  "value": {
-    "thing:/the_resource_path": {
-      "__schemaVersion": 2,
-      "grant": [
-        "READ",
-        "WRITE"
-      ],
-      "revoke": []
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourcesresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourcesresponse.md
deleted file mode 100644
index 3e566d8..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourcesresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## ModifyResourcesResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubject.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubject.md
deleted file mode 100644
index 4350c5e..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubject.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## ModifySubject
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects/google:the_subjectid",
-  "value": {
-    "type": "yourSubjectTypeDescription"
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponse.md
deleted file mode 100644
index 9041b1c..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## ModifySubjectResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects/google:the_subjectid",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponsecreated.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponsecreated.md
deleted file mode 100644
index a6db6dd..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponsecreated.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## ModifySubjectResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects/google:the_subjectid",
-  "value": {
-    "type": "yourSubjectTypeDescription"
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjects.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjects.md
deleted file mode 100644
index 31ae8ae..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjects.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## ModifySubjects
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects",
-  "value": {
-    "google:the_subjectid": {
-      "__schemaVersion": 2,
-      "type": "yourSubjectTypeDescription"
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectsresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectsresponse.md
deleted file mode 100644
index 65de882..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectsresponse.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## ModifySubjectsResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/modify",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicy.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicy.md
deleted file mode 100644
index e158e97..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicy.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrievePolicy
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentries.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentries.md
deleted file mode 100644
index a828586..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentries.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrievePolicyEntries
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentriesresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentriesresponse.md
deleted file mode 100644
index 82eb727..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentriesresponse.md
+++ /dev/null
@@ -1,46 +0,0 @@
-## RetrievePolicyEntriesResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries",
-  "value": {
-    "another_label": {
-      "subjects": {
-        "google:the_subjectid": {
-          "type": "yourSubjectTypeDescription"
-        }
-      },
-      "resources": {
-        "thing:/the_resource_path": {
-          "grant": [
-            "READ",
-            "WRITE"
-          ],
-          "revoke": []
-        }
-      }
-    },
-    "the_label": {
-      "subjects": {
-        "google:the_subjectid": {
-          "type": "yourSubjectTypeDescription"
-        }
-      },
-      "resources": {
-        "thing:/the_resource_path": {
-          "grant": [
-            "READ",
-            "WRITE"
-          ],
-          "revoke": []
-        }
-      }
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentry.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentry.md
deleted file mode 100644
index 5b05b07..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentry.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrievePolicyEntry
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentryresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentryresponse.md
deleted file mode 100644
index ede4adc..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentryresponse.md
+++ /dev/null
@@ -1,28 +0,0 @@
-## RetrievePolicyEntryResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label",
-  "value": {
-    "subjects": {
-      "google:the_subjectid": {
-        "type": "yourSubjectTypeDescription"
-      }
-    },
-    "resources": {
-      "thing:/the_resource_path": {
-        "grant": [
-          "READ",
-          "WRITE"
-        ],
-        "revoke": []
-      }
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyresponse.md
deleted file mode 100644
index 370e37d..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyresponse.md
+++ /dev/null
@@ -1,33 +0,0 @@
-## RetrievePolicyResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "policyId": "com.acme:the_policy_id",
-    "entries": {
-      "the_label": {
-        "subjects": {
-          "google:the_subjectid": {
-            "type": "yourSubjectTypeDescription"
-          }
-        },
-        "resources": {
-          "thing:/the_resource_path": {
-            "grant": [
-              "READ",
-              "WRITE"
-            ],
-            "revoke": []
-          }
-        }
-      }
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresource.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresource.md
deleted file mode 100644
index ac35e20..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresource.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrieveResource
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources/thing:/the_resource_path"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourceresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourceresponse.md
deleted file mode 100644
index 572904d..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourceresponse.md
+++ /dev/null
@@ -1,19 +0,0 @@
-## RetrieveResourceResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources/thing:/the_resource_path",
-  "value": {
-    "grant": [
-      "READ",
-      "WRITE"
-    ],
-    "revoke": []
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresources.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresources.md
deleted file mode 100644
index 57fcc78..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresources.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrieveResources
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourcesresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourcesresponse.md
deleted file mode 100644
index 2396c6d..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourcesresponse.md
+++ /dev/null
@@ -1,21 +0,0 @@
-## RetrieveResourcesResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/resources",
-  "value": {
-    "thing:/the_resource_path": {
-      "grant": [
-        "READ",
-        "WRITE"
-      ],
-      "revoke": []
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubject.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubject.md
deleted file mode 100644
index 13f9067..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubject.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrieveSubject
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects/google:the_subjectid"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectresponse.md
deleted file mode 100644
index 6bc9dc5..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectresponse.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## RetrieveSubjectResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects/google:the_subjectid",
-  "value": {
-    "type": "yourSubjectTypeDescription"
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjects.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjects.md
deleted file mode 100644
index 28093c3..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjects.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrieveSubjects
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects"
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectsresponse.md b/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectsresponse.md
deleted file mode 100644
index f5d9338..0000000
--- a/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectsresponse.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## RetrieveSubjectsResponse
-
-```json
-{
-  "topic": "com.acme/the_policy_id/policies/commands/retrieve",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/entries/the_label/subjects",
-  "value": {
-    "google:the_subjectid": {
-      "type": "yourSubjectTypeDescription"
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_invalid.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_invalid.md
deleted file mode 100644
index a9e364f..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_invalid.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:entry.invalid
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "policies:entry.invalid",
-    "message": "The Policy Entry is invalid.",
-    "description": "Policy entry does not contain any known permission like 'READ' or 'WRITE'"
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_modificationinvalid.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_modificationinvalid.md
deleted file mode 100644
index 0f33519..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_modificationinvalid.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:entry.modificationinvalid
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:entry.modificationinvalid",
-    "message": "The PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the resulting Policy would be invalid.",
-    "description": "There must always be at least one PolicyEntry with 'WRITE' permissions on resource 'policy:/'."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notfound.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notfound.md
deleted file mode 100644
index 2058514..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notfound.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:entry.notfound
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:entry.notfound",
-    "message": "The PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Policy and the Label of your requested PolicyEntry was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notmodifiable.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notmodifiable.md
deleted file mode 100644
index abfb884..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notmodifiable.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:entry.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:entry.notmodifiable",
-    "message": "The PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of the Policy and the Label of your requested PolicyEntry was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_id_invalid.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_id_invalid.md
deleted file mode 100644
index ec98406..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_id_invalid.md
+++ /dev/null
@@ -1,19 +0,0 @@
-## policies:id.invalid
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "policies:id.invalid",
-    "message": "Policy ID 'invalid id' is not valid!",
-    "description": "It must conform to the namespaced entity ID notation (see Ditto documentation)",
-    "href": "https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id"
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_conflict.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_conflict.md
deleted file mode 100644
index de04a2a..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_conflict.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:policy.conflict
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 409,
-    "error": "policies:policy.conflict",
-    "message": "The Policy with ID 'com.acme:the_policy_id' already exists",
-    "description": "Choose another Policy ID"
-  },
-  "status": 409
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_modificationinvalid.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_modificationinvalid.md
deleted file mode 100644
index aa7b0aa..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_modificationinvalid.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:policy.modificationinvalid
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:policy.modificationinvalid",
-    "message": "The Policy with ID 'com.acme:the_policy_id' could not be modified as the resulting Policy would be invalid.",
-    "description": "There must always be at least one PolicyEntry with 'WRITE' permissions on resource 'policy:/'."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notfound.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notfound.md
deleted file mode 100644
index 95cacea..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notfound.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:policy.notfound
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:policy.notfound",
-    "message": "The Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of your requested Policy was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notmodifiable.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notmodifiable.md
deleted file mode 100644
index 66eb41f..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notmodifiable.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:policy.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:policy.notmodifiable",
-    "message": "The Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of your requested Policy was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_toomanymodifyingrequests.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_toomanymodifyingrequests.md
deleted file mode 100644
index cf16d09..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_toomanymodifyingrequests.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:policy.toomanymodifyingrequests
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 429,
-    "error": "policies:policy.toomanymodifyingrequests",
-    "message": "Too many modifying requests are already outstanding to the Policy with ID 'com.acme:the_policy_id'.",
-    "description": "Throttle your modifying requests to the Policy or re-structure your Policy in multiple Policies if you really need so many concurrent modifications."
-  },
-  "status": 429
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_unavailable.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_unavailable.md
deleted file mode 100644
index 46b2154..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_unavailable.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:policy.unavailable
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 503,
-    "error": "policies:policy.unavailable",
-    "message": "The Policy with ID 'com.acme:the_policy_id' is not available, please try again later.",
-    "description": "The requested Policy is temporarily not available."
-  },
-  "status": 503
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notfound.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notfound.md
deleted file mode 100644
index 75668a4..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notfound.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:resource.notfound
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:resource.notfound",
-    "message": "The Resource '/the_resource_path' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Policy, the Label of the PolicyEntry and the path of your requested Resource was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notmodifiable.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notmodifiable.md
deleted file mode 100644
index d94d101..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notmodifiable.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:resource.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:resource.notmodifiable",
-    "message": "The Resource '/the_resource_path' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of the Policy, the Label of the PolicyEntry and the path of your requested Resource was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notfound.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notfound.md
deleted file mode 100644
index d53e4e8..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notfound.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:resources.notfound
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:resources.notfound",
-    "message": "The Resources of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Policy and the Label of the PolicyEntry was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notmodifiable.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notmodifiable.md
deleted file mode 100644
index 20ddefb..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notmodifiable.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:resources.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:resources.notmodifiable",
-    "message": "The Resources of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of the Policy and the PolicyEntry's Label of your requested Resources was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notfound.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notfound.md
deleted file mode 100644
index 288b808..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notfound.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:subject.notfound
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:subject.notfound",
-    "message": "The Subject with ID 'google:the_subjectid' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Policy, the Label of the PolicyEntry and ID of your requested Subject was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notmodifiable.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notmodifiable.md
deleted file mode 100644
index 705a9b0..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notmodifiable.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:subject.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:subject.notmodifiable",
-    "message": "The Subject with ID 'google:the_subjectid' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of the Policy, the Label of the PolicyEntry and ID of your requested Subject was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjectid_invalid.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjectid_invalid.md
deleted file mode 100644
index ac5b4c3..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjectid_invalid.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:subjectid.invalid
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "policies:subjectid.invalid",
-    "message": "Subject ID 'invalid subject' is not valid!",
-    "description": "It must contain an issuer as prefix separated by a colon ':' from the actual subject"
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notfound.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notfound.md
deleted file mode 100644
index 4877562..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notfound.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:subjects.notfound
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:subjects.notfound",
-    "message": "The Subjects of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Policy and the Label of the PolicyEntry was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notmodifiable.md b/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notmodifiable.md
deleted file mode 100644
index 6497157..0000000
--- a/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notmodifiable.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## policies:subjects.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/policies/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:subjects.notmodifiable",
-    "message": "The Subjects of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of the Policy and the PolicyEntry's Label of your requested Subjects was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/search/generated/commands/cancel-subscription-command.md b/pages/ditto/protocol/examples/search/generated/commands/cancel-subscription-command.md
deleted file mode 100644
index 813e45b..0000000
--- a/pages/ditto/protocol/examples/search/generated/commands/cancel-subscription-command.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## CancelSubscription
-
-```json
-{
-  "topic": "_/_/things/twin/search/cancel",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "subscriptionId": "24601"
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/search/generated/commands/create-subscription-command.md b/pages/ditto/protocol/examples/search/generated/commands/create-subscription-command.md
deleted file mode 100644
index f27ea02..0000000
--- a/pages/ditto/protocol/examples/search/generated/commands/create-subscription-command.md
+++ /dev/null
@@ -1,20 +0,0 @@
-## CreateSubscription
-
-```json
-{
-  "topic": "_/_/things/twin/search/subscribe",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json",
-    "correlation-id": "444dae7e-bacf-312b-bc97-8f393dadf1bd"
-  },
-  "path": "/",
-  "value": {
-    "filter": "eq(/attributes/temperature,32)",
-    "options": "size(10),sort(+thingId)",
-    "namespaces": [
-      "org.eclipse.ditto"
-    ]
-  },
-  "fields": "attributes"
-}
-```
diff --git a/pages/ditto/protocol/examples/search/generated/commands/request-subscription-command.md b/pages/ditto/protocol/examples/search/generated/commands/request-subscription-command.md
deleted file mode 100644
index d2140b0..0000000
--- a/pages/ditto/protocol/examples/search/generated/commands/request-subscription-command.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## RequestFromSubscription
-
-```json
-{
-  "topic": "_/_/things/twin/search/request",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "subscriptionId": "24601",
-    "demand": 3
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/search/generated/events/subscription-complete-event.md b/pages/ditto/protocol/examples/search/generated/events/subscription-complete-event.md
deleted file mode 100644
index 845c43f..0000000
--- a/pages/ditto/protocol/examples/search/generated/events/subscription-complete-event.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## SubscriptionComplete
-
-```json
-{
-  "topic": "_/_/things/twin/search/complete",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "subscriptionId": "24601"
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/search/generated/events/subscription-created-event.md b/pages/ditto/protocol/examples/search/generated/events/subscription-created-event.md
deleted file mode 100644
index 03abc59..0000000
--- a/pages/ditto/protocol/examples/search/generated/events/subscription-created-event.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## SubscriptionCreated
-
-```json
-{
-  "topic": "_/_/things/twin/search/created",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json",
-    "correlation-id": "444dae7e-bacf-312b-bc97-8f393dadf1bd"
-  },
-  "path": "/",
-  "value": {
-    "subscriptionId": "24601"
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/search/generated/events/subscription-failed-event.md b/pages/ditto/protocol/examples/search/generated/events/subscription-failed-event.md
deleted file mode 100644
index de23850..0000000
--- a/pages/ditto/protocol/examples/search/generated/events/subscription-failed-event.md
+++ /dev/null
@@ -1,20 +0,0 @@
-## SubscriptionFailed
-
-```json
-{
-  "topic": "_/_/things/twin/search/failed",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "subscriptionId": "24601",
-    "error": {
-      "status": 400,
-      "error": "thing-search:subscription.protocol.error",
-      "message": "Rule 3.9: While the Subscription is not cancelled, Subscription.request(long n) MUST signal onError with a java.lang.IllegalArgumentException if the argument is <= 0. The cause message SHOULD explain that non-positive request signals are illegal.",
-      "description": "The intent of this rule is to prevent faulty implementations to proceed operation without any exceptions being raised. Requesting a negative or 0 number of elements, since requests are additive, most likely to be the result of an erroneous calculation on the behalf of the Subscriber."
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/search/generated/events/subscription-has-next-event.md b/pages/ditto/protocol/examples/search/generated/events/subscription-has-next-event.md
deleted file mode 100644
index 6294f64..0000000
--- a/pages/ditto/protocol/examples/search/generated/events/subscription-has-next-event.md
+++ /dev/null
@@ -1,26 +0,0 @@
-## SubscriptionNextPage
-
-```json
-{
-  "topic": "_/_/things/twin/search/next",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "subscriptionId": "24601",
-    "items": [{
-        "thingId": "default:thing1",
-        "attributes": {
-          "temperature": 35
-        }
-      },
-      {
-        "thingId": "default:thing2",
-        "attributes": {
-          "temperature": 35
-        }
-      }]
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/search/generated/exceptions/thing-search_search_option_invalid.md b/pages/ditto/protocol/examples/search/generated/exceptions/thing-search_search_option_invalid.md
deleted file mode 100644
index b7e5a59..0000000
--- a/pages/ditto/protocol/examples/search/generated/exceptions/thing-search_search_option_invalid.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## thing-search:search.option.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {
-    "content-type": "application/vnd.eclipse.ditto+json"
-  },
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "thing-search:search.option.invalid",
-    "description": "At least one provided option is invalid."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/creatething.md b/pages/ditto/protocol/examples/things/generated/commands/modify/creatething.md
deleted file mode 100644
index efc7daf..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/creatething.md
+++ /dev/null
@@ -1,32 +0,0 @@
-## CreateThing
-
-Creates a new Thing with ID ``com.acme:xdk_53`` that uses an existing Policy with ID ``com.acme:the_policy_id``.
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/create",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "definition": "com.acme:XDKmodel:1.0.0",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/createthingalternatives.md b/pages/ditto/protocol/examples/things/generated/commands/modify/createthingalternatives.md
deleted file mode 100644
index d14a0af..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/createthingalternatives.md
+++ /dev/null
@@ -1,38 +0,0 @@
-## Alternative CreateThing commands
-
-If you want to copy an existing Policy instead of creating a new one by yourself or reference an existing Policy, you
-can adjust the CreateThing command like demonstrated in the following examples.
-
-### CreateThing with copied Policy by Policy ID
-
-Creates a new Thing with ID ``com.acme:xdk_53`` with a Policy copied from the Policy with ID ``com.acme:the_policy_id_to_copy``.
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/create",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "_copyPolicyFrom": "com:acme:the_policy_id_to_copy"
-  }
-}
-```
-
-### CreateThing with copied Policy by Thing reference
-
-Creates a new Thing with ID ``com.acme:xdk_53`` with a Policy copied from a Thing with ID ``com.acme:xdk_52``.
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/create",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "_copyPolicyFrom": "{% raw %}{{ ref:things/com:acme:xdk_52/policyId }}{% endraw %}"
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/createthingresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/createthingresponse.md
deleted file mode 100644
index c9c49fa..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/createthingresponse.md
+++ /dev/null
@@ -1,31 +0,0 @@
-## CreateThingResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/create",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "definition": "com.acme:XDKmodel:1.0.0",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deleteaclentry.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deleteaclentry.md
deleted file mode 100644
index d5e2300..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deleteaclentry.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteAclEntry
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/acl/the_auth_subject"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattribute.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattribute.md
deleted file mode 100644
index 9c8e5bf..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattribute.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteAttribute
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/attributes/location"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributeresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributeresponse.md
deleted file mode 100644
index 5fd4add..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributeresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteAttributeResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/attributes/location",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributes.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributes.md
deleted file mode 100644
index 7943ad0..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributes.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteAttributes
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/attributes"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributesresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributesresponse.md
deleted file mode 100644
index 8231231..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributesresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteAttributesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/attributes",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeature.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeature.md
deleted file mode 100644
index a29caf0..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeature.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteFeature
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinition.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinition.md
deleted file mode 100644
index ff0edda..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinition.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteFeatureDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/definition"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinitionresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinitionresponse.md
deleted file mode 100644
index decd88e..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinitionresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteFeatureDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperties.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperties.md
deleted file mode 100644
index ccc9565..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperties.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteFeatureProperties
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/properties"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertiesresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertiesresponse.md
deleted file mode 100644
index f4fe6ad..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertiesresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteFeaturePropertiesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperty.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperty.md
deleted file mode 100644
index 4d1edc6..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperty.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteFeatureProperty
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertyresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertyresponse.md
deleted file mode 100644
index cbd699d..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertyresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteFeaturePropertyResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureresponse.md
deleted file mode 100644
index 51b8638..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteFeatureResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatures.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatures.md
deleted file mode 100644
index b84efe8..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatures.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteFeatures
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturesresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturesresponse.md
deleted file mode 100644
index 423f5e3..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturesresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteFeaturesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletething.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletething.md
deleted file mode 100644
index f195323..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletething.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteThing
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinition.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinition.md
deleted file mode 100644
index e555a5a..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinition.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteThingDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/definition"
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinitionresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinitionresponse.md
deleted file mode 100644
index 17771eb..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinitionresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteThingDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/definition",
-  "status": 204
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingresponse.md
deleted file mode 100644
index d06086a..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteThingResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyacl.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyacl.md
deleted file mode 100644
index b50326e..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyacl.md
+++ /dev/null
@@ -1,21 +0,0 @@
-## ModifyAcl
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/acl",
-  "value": {
-    "the_auth_subject_2": {
-      "READ": true,
-      "WRITE": false,
-      "ADMINISTRATE": false
-    },
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyaclentry.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyaclentry.md
deleted file mode 100644
index d7faaa5..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyaclentry.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## ModifyAclEntry
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/acl/the_auth_subject",
-  "value": {
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattribute.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattribute.md
deleted file mode 100644
index 7a1a956..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattribute.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## ModifyAttribute
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes/location",
-  "value": {
-    "latitude": 44.673856,
-    "longitude": 8.261719
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponse.md
deleted file mode 100644
index 372a011..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyAttributeResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes/location",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponsecreated.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponsecreated.md
deleted file mode 100644
index aef0cd1..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponsecreated.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## ModifyAttributeResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes/location",
-  "value": {
-    "latitude": 44.673856,
-    "longitude": 8.261719
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributes.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributes.md
deleted file mode 100644
index 8817bea..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributes.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## ModifyAttributes
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes",
-  "value": {
-    "location": {
-      "latitude": 44.673856,
-      "longitude": 8.261719
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponse.md
deleted file mode 100644
index 5270496..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyAttributesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes",
-  "value": null,
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponsecreated.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponsecreated.md
deleted file mode 100644
index 01c5fb6..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponsecreated.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## ModifyAttributesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes",
-  "value": {
-    "location": {
-      "latitude": 44.673856,
-      "longitude": 8.261719
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeature.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeature.md
deleted file mode 100644
index 7c271df..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeature.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## ModifyFeature
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": {
-    "properties": {
-      "x": 3.141,
-      "y": 2.718,
-      "z": 1,
-      "unit": "g"
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinition.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinition.md
deleted file mode 100644
index 6394dec..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinition.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## ModifyFeatureDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "value": [
-    "com.acme:accelerometer:1.0.0"
-  ]
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponse.md
deleted file mode 100644
index 4a1d67d..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyFeatureDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponsecreated.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponsecreated.md
deleted file mode 100644
index 63e8809..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponsecreated.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## ModifyFeatureDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "value": [
-    "com.acme:accelerometer:1.0.0"
-  ],
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperties.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperties.md
deleted file mode 100644
index dee3d4e..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperties.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## ModifyFeatureProperties
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "value": {
-    "x": 3.141,
-    "y": 2.718,
-    "z": 1,
-    "unit": "g"
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponse.md
deleted file mode 100644
index 6ba2774..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyFeaturePropertiesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponsecreated.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponsecreated.md
deleted file mode 100644
index 348c2af..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponsecreated.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## ModifyFeaturePropertiesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "value": {
-    "x": 3.141,
-    "y": 2.718,
-    "z": 1,
-    "unit": "g"
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperty.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperty.md
deleted file mode 100644
index f1c19f0..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperty.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyFeatureProperty
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "value": 42
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponse.md
deleted file mode 100644
index 909beb2..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyFeaturePropertyResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponsecreated.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponsecreated.md
deleted file mode 100644
index 2ef2815..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponsecreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyFeaturePropertyResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "value": 42,
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponse.md
deleted file mode 100644
index b217b28..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyFeatureResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": null,
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponsecreated.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponsecreated.md
deleted file mode 100644
index 525eb5e..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponsecreated.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## ModifyFeatureResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": {
-    "properties": {
-      "x": 3.141,
-      "y": 2.718,
-      "z": 1,
-      "unit": "g"
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatures.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatures.md
deleted file mode 100644
index 2fc678e..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatures.md
+++ /dev/null
@@ -1,19 +0,0 @@
-## ModifyFeatures
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features",
-  "value": {
-    "accelerometer": {
-      "properties": {
-        "x": 3.141,
-        "y": 2.718,
-        "z": 1,
-        "unit": "g"
-      }
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponse.md
deleted file mode 100644
index e519ae7..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyFeaturesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features",
-  "value": null,
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponsecreated.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponsecreated.md
deleted file mode 100644
index 8f1cd40..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponsecreated.md
+++ /dev/null
@@ -1,20 +0,0 @@
-## ModifyFeaturesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features",
-  "value": {
-    "accelerometer": {
-      "properties": {
-        "x": 3.141,
-        "y": 2.718,
-        "z": 1,
-        "unit": "g"
-      }
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyid.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyid.md
deleted file mode 100644
index d10de0a..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyid.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyPolicyId
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/policyId",
-  "value": "com.acme:the_policy_id"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsecreated.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsecreated.md
deleted file mode 100644
index 233db0c..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsecreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyPolicyIdResponse when Thing had no Policy ID yet
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/policyId",
-  "value": "com.acme:the_policy_id",
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsemodified.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsemodified.md
deleted file mode 100644
index 62d5c5c..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsemodified.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyPolicyIdResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/policyId",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifything.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifything.md
deleted file mode 100644
index a115641..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifything.md
+++ /dev/null
@@ -1,30 +0,0 @@
-## ModifyThing
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "definition": "com.acme:XDKmodel:1.0.0",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingalternatives.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingalternatives.md
deleted file mode 100644
index 9f5176d..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingalternatives.md
+++ /dev/null
@@ -1,42 +0,0 @@
-## Alternative ModifyThing commands
-
-If you want to copy an existing Policy instead of creating a new one by yourself or reference an existing Policy, you
-can adjust the ModifyThing command like demonstrated in the following examples.<br/>
-This only works if a Thing with the given ``thingId`` does not exist, yet. If it exists the ``_copyPolicyFrom`` field
-will be ignored.
-
-### ModifyThing with copied Policy by Policy ID
-
-If no Thing with ID ``com.acme:xdk_53`` exists, this command will create a new Thing with ID ``com.acme:xdk_53`` with a
-Policy copied from the Policy with ID ``com.acme:the_policy_id_to_copy``.
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "_copyPolicyFrom": "com:acme:the_policy_id_to_copy"
-  }
-}
-```
-
-### ModifyThing with copied Policy by Thing reference
-
-If no Thing with ID ``com.acme:xdk_53`` exists, this command will create a new Thing with ID ``com.acme:xdk_53`` with a
-Policy copied from a Thing with ID ``com.acme:xdk_52``.
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "_copyPolicyFrom": "{% raw %}{{ ref:things/com:acme:xdk_52/policyId }}{% endraw %}"
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinition.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinition.md
deleted file mode 100644
index a83a519..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinition.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyThingDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/definition",
-  "value": "digitaltwin:DigitaltwinExample:1.0.0"
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponse.md
deleted file mode 100644
index d1c9a54..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyThingDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/definition",
-  "status": 204
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponsecreated.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponsecreated.md
deleted file mode 100644
index b4019d0..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponsecreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyThingDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/definition",
-  "value": "digitaltwin:DigitaltwinExample:1.0.0",
-  "status": 201
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponse.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponse.md
deleted file mode 100644
index 33ebfef..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyThingResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponsecreated.md b/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponsecreated.md
deleted file mode 100644
index 3844752..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponsecreated.md
+++ /dev/null
@@ -1,31 +0,0 @@
-## ModifyThingResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "definition": "com.acme:XDKmodel:1.0.0",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveacl.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrieveacl.md
deleted file mode 100644
index 1cfe713..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveacl.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveAcl
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/acl"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveaclentry.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrieveaclentry.md
deleted file mode 100644
index 817303b..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveaclentry.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveAclEntry
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/acl/the_auth_subject"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveaclentryresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrieveaclentryresponse.md
deleted file mode 100644
index 51c4c09..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveaclentryresponse.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## RetrieveAclEntryResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/acl/the_auth_subject",
-  "value": {
-    "READ": true,
-    "WRITE": true,
-    "ADMINISTRATE": true
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveaclresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrieveaclresponse.md
deleted file mode 100644
index eb64f76..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveaclresponse.md
+++ /dev/null
@@ -1,22 +0,0 @@
-## RetrieveAclResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/acl",
-  "value": {
-    "the_auth_subject_2": {
-      "READ": true,
-      "WRITE": false,
-      "ADMINISTRATE": false
-    },
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattribute.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattribute.md
deleted file mode 100644
index 0898d1d..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattribute.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveAttribute
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/attributes/location"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributeresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributeresponse.md
deleted file mode 100644
index ad9b6d4..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributeresponse.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## RetrieveAttributeResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/attributes/location",
-  "value": {
-    "latitude": 44.673856,
-    "longitude": 8.261719
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes-selectedfields.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes-selectedfields.md
deleted file mode 100644
index 5d7b5b1..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes-selectedfields.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## RetrieveAttributes
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/attributes",
-  "fields": "attributes"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes.md
deleted file mode 100644
index 586875e..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveAttributes
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/attributes"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributesresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributesresponse.md
deleted file mode 100644
index d918839..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributesresponse.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## RetrieveAttributesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/attributes",
-  "value": {
-    "location": {
-      "latitude": 44.673856,
-      "longitude": 8.261719
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeature.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeature.md
deleted file mode 100644
index 2222d92..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeature.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveFeature
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinition.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinition.md
deleted file mode 100644
index aa71318..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinition.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveFeatureDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/definition"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinitionresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinitionresponse.md
deleted file mode 100644
index b986bb3..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinitionresponse.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## RetrieveFeatureDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "value": [
-    "com.acme:accelerometer:1.0.0"
-  ],
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties-selectedfields.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties-selectedfields.md
deleted file mode 100644
index 88b8247..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties-selectedfields.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## RetrieveFeatureProperties
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "fields": "properties/target_year_1"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties.md
deleted file mode 100644
index 5cf92be..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveFeatureProperties
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/properties"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertiesresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertiesresponse.md
deleted file mode 100644
index 4e8e15d..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertiesresponse.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## RetrieveFeaturePropertiesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "value": {
-    "x": 3.141,
-    "y": 2.718,
-    "z": 1,
-    "unit": "g"
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperty.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperty.md
deleted file mode 100644
index ba82364..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperty.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveFeatureProperty
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertyresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertyresponse.md
deleted file mode 100644
index 46ef144..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertyresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrieveFeaturePropertyResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "value": 42,
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureresponse.md
deleted file mode 100644
index e26464b..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureresponse.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## RetrieveFeatureResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": {
-    "properties": {
-      "x": 3.141,
-      "y": 2.718,
-      "z": 1,
-      "unit": "g"
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatures.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatures.md
deleted file mode 100644
index 24a6ad3..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatures.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveFeatures
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturesresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturesresponse.md
deleted file mode 100644
index 212df08..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturesresponse.md
+++ /dev/null
@@ -1,20 +0,0 @@
-## RetrieveFeaturesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features",
-  "value": {
-    "accelerometer": {
-      "properties": {
-        "x": 3.141,
-        "y": 2.718,
-        "z": 1,
-        "unit": "g"
-      }
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyid.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyid.md
deleted file mode 100644
index c732577..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyid.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrievePolicyId
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/policyId"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyidresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyidresponse.md
deleted file mode 100644
index 0cd6cf0..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyidresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrievePolicyIdResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/policyId",
-  "value": "com.acme:the_policy_id",
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withfieldselector.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withfieldselector.md
deleted file mode 100644
index fa8326b..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withfieldselector.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## RetrieveThing
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/",
-  "fields": "thingId,attributes(location)"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withsnapshotrevision.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withsnapshotrevision.md
deleted file mode 100644
index f01ba77..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withsnapshotrevision.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveThing
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievething.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievething.md
deleted file mode 100644
index f01ba77..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievething.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveThing
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinition.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinition.md
deleted file mode 100644
index d319cc4..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinition.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/definition"
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinitionresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinitionresponse.md
deleted file mode 100644
index a5b8e17..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinitionresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrieveAttributeResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/definition",
-  "value": "digitaltwin:DigitaltwinExample:1.0.0",
-  "status": 200
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingresponse.md
deleted file mode 100644
index 299c182..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingresponse.md
+++ /dev/null
@@ -1,30 +0,0 @@
-## RetrieveThingResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings-withfieldselector.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings-withfieldselector.md
deleted file mode 100644
index 84adc59..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings-withfieldselector.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## RetrieveThings
-
-```json
-{
-  "topic": "_/_/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingIds": [
-      "com.acme:xdk_53",
-      "com.acme:xdk_58",
-      "com.acme:xdk_67"
-    ]
-  },
-  "fields": "thingId,attributes(location)"
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings.md
deleted file mode 100644
index 22bba13..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## RetrieveThings
-
-```json
-{
-  "topic": "_/_/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingIds": [
-      "com.acme:xdk_53",
-      "com.acme:xdk_58",
-      "com.acme:xdk_67"
-    ]
-  }
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingsresponse.md b/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingsresponse.md
deleted file mode 100644
index b574622..0000000
--- a/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingsresponse.md
+++ /dev/null
@@ -1,30 +0,0 @@
-## RetrieveThingsResponse
-
-```json
-{
-  "topic": "com.acme/_/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/",
-  "value": [{
-      "thingId": "com.acme:xdk_53",
-      "policyId": "com.acme:the_policy_id",
-      "attributes": {
-        "location": {
-          "latitude": 44.673856,
-          "longitude": 8.261719
-        }
-      },
-      "features": {
-        "accelerometer": {
-          "properties": {
-            "x": 3.141,
-            "y": 2.718,
-            "z": 1,
-            "unit": "g"
-          }
-        }
-      }
-    }],
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/aclentrycreated.md b/pages/ditto/protocol/examples/things/generated/events/aclentrycreated.md
deleted file mode 100644
index 9217d6d..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/aclentrycreated.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## AclEntryCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/acl/the_auth_subject",
-  "value": {
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/aclentrydeleted.md b/pages/ditto/protocol/examples/things/generated/events/aclentrydeleted.md
deleted file mode 100644
index ceefb2e..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/aclentrydeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## AclEntryDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/acl/the_auth_subject",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/aclentrymodified.md b/pages/ditto/protocol/examples/things/generated/events/aclentrymodified.md
deleted file mode 100644
index f1485b5..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/aclentrymodified.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## AclEntryModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/acl/the_auth_subject",
-  "value": {
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/aclmodified.md b/pages/ditto/protocol/examples/things/generated/events/aclmodified.md
deleted file mode 100644
index e711b99..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/aclmodified.md
+++ /dev/null
@@ -1,22 +0,0 @@
-## AclModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/acl",
-  "value": {
-    "the_auth_subject_2": {
-      "READ": true,
-      "WRITE": false,
-      "ADMINISTRATE": false
-    },
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/attributecreated.md b/pages/ditto/protocol/examples/things/generated/events/attributecreated.md
deleted file mode 100644
index da9ff3e..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/attributecreated.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## AttributeCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/attributes/location",
-  "value": {
-    "latitude": 44.673856,
-    "longitude": 8.261719
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/attributedeleted.md b/pages/ditto/protocol/examples/things/generated/events/attributedeleted.md
deleted file mode 100644
index 38cf420..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/attributedeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## AttributeDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/attributes/location",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/attributemodified.md b/pages/ditto/protocol/examples/things/generated/events/attributemodified.md
deleted file mode 100644
index 402ea9f..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/attributemodified.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## AttributeModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/attributes/location",
-  "value": {
-    "latitude": 44.673856,
-    "longitude": 8.261719
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/attributescreated.md b/pages/ditto/protocol/examples/things/generated/events/attributescreated.md
deleted file mode 100644
index 67c13f0..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/attributescreated.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## AttributesCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/attributes",
-  "value": {
-    "location": {
-      "latitude": 44.673856,
-      "longitude": 8.261719
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/attributesdeleted.md b/pages/ditto/protocol/examples/things/generated/events/attributesdeleted.md
deleted file mode 100644
index e8b5ba7..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/attributesdeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## AttributesDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/attributes",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/attributesmodified.md b/pages/ditto/protocol/examples/things/generated/events/attributesmodified.md
deleted file mode 100644
index 9f9303f..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/attributesmodified.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## AttributesModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/attributes",
-  "value": {
-    "location": {
-      "latitude": 44.673856,
-      "longitude": 8.261719
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featurecreated.md b/pages/ditto/protocol/examples/things/generated/events/featurecreated.md
deleted file mode 100644
index 3460fa2..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featurecreated.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## FeatureCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": {
-    "properties": {
-      "x": 3.141,
-      "y": 2.718,
-      "z": 1,
-      "unit": "g"
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featuredefinitioncreated.md b/pages/ditto/protocol/examples/things/generated/events/featuredefinitioncreated.md
deleted file mode 100644
index bb30d85..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featuredefinitioncreated.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## FeatureDefinitionCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "value": [
-    "com.acme:accelerometer:1.0.0"
-  ],
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featuredefinitiondeleted.md b/pages/ditto/protocol/examples/things/generated/events/featuredefinitiondeleted.md
deleted file mode 100644
index 1c7fba5..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featuredefinitiondeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## FeatureDefinitionDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featuredefinitionmodified.md b/pages/ditto/protocol/examples/things/generated/events/featuredefinitionmodified.md
deleted file mode 100644
index 3e694d1..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featuredefinitionmodified.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## FeatureDefinitionModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "value": [
-    "com.acme:accelerometer:1.0.0"
-  ],
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featuredeleted.md b/pages/ditto/protocol/examples/things/generated/events/featuredeleted.md
deleted file mode 100644
index b490a8e..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featuredeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## FeatureDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featuremodified.md b/pages/ditto/protocol/examples/things/generated/events/featuremodified.md
deleted file mode 100644
index 091c434..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featuremodified.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## FeatureModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": {
-    "properties": {
-      "x": 3.141,
-      "y": 2.718,
-      "z": 1,
-      "unit": "g"
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featurepropertiescreated.md b/pages/ditto/protocol/examples/things/generated/events/featurepropertiescreated.md
deleted file mode 100644
index 9bc8e6a..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featurepropertiescreated.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## FeaturePropertiesCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "value": {
-    "x": 3.141,
-    "y": 2.718,
-    "z": 1,
-    "unit": "g"
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featurepropertiesdeleted.md b/pages/ditto/protocol/examples/things/generated/events/featurepropertiesdeleted.md
deleted file mode 100644
index 62408b0..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featurepropertiesdeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## FeaturePropertiesDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featurepropertiesmodified.md b/pages/ditto/protocol/examples/things/generated/events/featurepropertiesmodified.md
deleted file mode 100644
index 87e4782..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featurepropertiesmodified.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## FeaturePropertiesModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "value": {
-    "x": 3.141,
-    "y": 2.718,
-    "z": 1,
-    "unit": "g"
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featurepropertycreated.md b/pages/ditto/protocol/examples/things/generated/events/featurepropertycreated.md
deleted file mode 100644
index 3e443ea..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featurepropertycreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## FeaturePropertyCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "value": 42,
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featurepropertydeleted.md b/pages/ditto/protocol/examples/things/generated/events/featurepropertydeleted.md
deleted file mode 100644
index 1f7d326..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featurepropertydeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## FeaturePropertyDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featurepropertymodified.md b/pages/ditto/protocol/examples/things/generated/events/featurepropertymodified.md
deleted file mode 100644
index 8b6e7f2..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featurepropertymodified.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## FeaturePropertyModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "value": 42,
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featurescreated.md b/pages/ditto/protocol/examples/things/generated/events/featurescreated.md
deleted file mode 100644
index 18ed968..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featurescreated.md
+++ /dev/null
@@ -1,20 +0,0 @@
-## FeaturesCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/features",
-  "value": {
-    "accelerometer": {
-      "properties": {
-        "x": 3.141,
-        "y": 2.718,
-        "z": 1,
-        "unit": "g"
-      }
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featuresdeleted.md b/pages/ditto/protocol/examples/things/generated/events/featuresdeleted.md
deleted file mode 100644
index d61a4e1..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featuresdeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## FeaturesDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/features",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/featuresmodified.md b/pages/ditto/protocol/examples/things/generated/events/featuresmodified.md
deleted file mode 100644
index 1deda20..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/featuresmodified.md
+++ /dev/null
@@ -1,20 +0,0 @@
-## FeaturesModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/features",
-  "value": {
-    "accelerometer": {
-      "properties": {
-        "x": 3.141,
-        "y": 2.718,
-        "z": 1,
-        "unit": "g"
-      }
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/policyidcreated.md b/pages/ditto/protocol/examples/things/generated/events/policyidcreated.md
deleted file mode 100644
index 078e368..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/policyidcreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## PolicyIdCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/policyId",
-  "value": "com.acme:the_policy_id",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/policyidmodified.md b/pages/ditto/protocol/examples/things/generated/events/policyidmodified.md
deleted file mode 100644
index 4f4c39d..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/policyidmodified.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## PolicyIdModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/policyId",
-  "value": "com.acme:the_policy_id",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/thingcreated.md b/pages/ditto/protocol/examples/things/generated/events/thingcreated.md
deleted file mode 100644
index d6c7266..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/thingcreated.md
+++ /dev/null
@@ -1,30 +0,0 @@
-## ThingCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/thingdefinitioncreated.md b/pages/ditto/protocol/examples/things/generated/events/thingdefinitioncreated.md
deleted file mode 100644
index 3452d07..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/thingdefinitioncreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## DefinitionCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/definition",
-  "value": "digitaltwin:DigitaltwinExample:1.0.0",
-  "revision": 2
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/examples/things/generated/events/thingdefinitiondeleted.md b/pages/ditto/protocol/examples/things/generated/events/thingdefinitiondeleted.md
deleted file mode 100644
index 7d23c71..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/thingdefinitiondeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DefinitionDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/definition",
-  "revision": 3
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/examples/things/generated/events/thingdefinitionmodified.md b/pages/ditto/protocol/examples/things/generated/events/thingdefinitionmodified.md
deleted file mode 100644
index 10b994e..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/thingdefinitionmodified.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## DefinitionModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/definition",
-  "value": "digitaltwin:DigitaltwinExample:1.0.0",
-  "revision": 3
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/thingdeleted.md b/pages/ditto/protocol/examples/things/generated/events/thingdeleted.md
deleted file mode 100644
index ce909d3..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/thingdeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ThingDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/events/thingmodified.md b/pages/ditto/protocol/examples/things/generated/events/thingmodified.md
deleted file mode 100644
index 6f938c3..0000000
--- a/pages/ditto/protocol/examples/things/generated/events/thingmodified.md
+++ /dev/null
@@ -1,30 +0,0 @@
-## ThingModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/thingerrorresponse.md b/pages/ditto/protocol/examples/things/generated/exceptions/thingerrorresponse.md
deleted file mode 100644
index 49dbc53..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/thingerrorresponse.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## ThingErrorResponse
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:thing.notfound",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_entry_invalid.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_entry_invalid.md
deleted file mode 100644
index 1693c37..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_entry_invalid.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## things:acl.entry.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:acl.entry.invalid",
-    "message": "The Access Control List Entry is invalid."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_invalid.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_invalid.md
deleted file mode 100644
index ccbcc7a..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_invalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:acl.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:acl.invalid",
-    "message": "The Access Control List of the Thing with ID 'com.acme:xdk_53' is invalid.",
-    "description": "There always has to be at least one ACL Entry with <READ, WRITE, ADMINISTRATE> permissions."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_modificationinvalid.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_modificationinvalid.md
deleted file mode 100644
index d8fbb7f..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_modificationinvalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:acl.modificationinvalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:acl.modificationinvalid",
-    "message": "The modified Access Control List of the Thing with ID 'com.acme:xdk_53' is invalid.",
-    "description": "There always has to be at least one ACL Entry with <READ, WRITE, ADMINISTRATE> permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_not_allowed.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_not_allowed.md
deleted file mode 100644
index b6f077e..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_not_allowed.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:acl.not.allowed
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:acl.not.allowed",
-    "message": "The schema version of the Thing with ID 'com.acme:xdk_53' does not allow Access Control List.",
-    "description": "Things in schema version 2 and higher use policies for permission management."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_notfound.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_notfound.md
deleted file mode 100644
index c9f2c0c..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:acl.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:acl.notfound",
-    "message": "The ACL Entry for the Authorization Subject 'the_acl_subject' on the Thing with ID 'com.acme:xdk_53' could not be found.",
-    "description": "Check if the ID of the Thing and the authorized subject of your request was correct."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_notmodifiable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_notmodifiable.md
deleted file mode 100644
index c6c3006..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_acl_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:acl.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:acl.notmodifiable",
-    "message": "The Access Control List of the Thing with ID 'com.acme:xdk_53' could not be modified.",
-    "description": "Check if the ID of the thing was correct and you have sufficient permissions. If you wanted to modify the complete Thing, try modifying it without also changing the Access Control List ('acl')."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notfound.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notfound.md
deleted file mode 100644
index 8574c5d..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:attribute.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:attribute.notfound",
-    "message": "The attribute with key '/location' on the thing with ID 'com.acme:xdk_53' could not be found or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the thing and the key of your requested attribute was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notmodifiable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notmodifiable.md
deleted file mode 100644
index b6a2f2d..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:attribute.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:attribute.notmodifiable",
-    "message": " The Attribute with name '/location' on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required).",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notfound.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notfound.md
deleted file mode 100644
index 40cf910..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:attributes.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:attributes.notfound",
-    "message": "The Attributes of the Thing with ID 'com.acme:xdk_53' could not be found or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notmodifiable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notmodifiable.md
deleted file mode 100644
index ebc8a86..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:attributes.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:attributes.notmodifiable",
-    "message": "The Attributes on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required).",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_empty.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_empty.md
deleted file mode 100644
index 060f68c..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_empty.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.definition.empty
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:feature.definition.empty",
-    "message": "Feature Definition must not be empty!",
-    "description": "A Feature Definition must contain at least one element. It can however also be set to null or deleted completely."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_identifier_invalid.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_identifier_invalid.md
deleted file mode 100644
index 62dd437..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_identifier_invalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.definition.identifier.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:feature.definition.identifier.invalid",
-    "message": "Feature Definition Identifier <foo:bar> is invalid!",
-    "description": "An Identifier string is expected to have the structure 'namespace:name:version'. Each segment must contain at least one char of [_a-zA-Z0-9\\-.]"
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notfound.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notfound.md
deleted file mode 100644
index 036a8eb..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.definition.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:feature.definition.notfound",
-    "message": "The Definition of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' does not exist or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notmodifiable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notmodifiable.md
deleted file mode 100644
index 457179e..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.definition.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:feature.definition.notmodifiable",
-    "message": "The Definition of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required).",
-    "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notfound.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notfound.md
deleted file mode 100644
index bef390d..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:feature.notfound",
-    "message": "The Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' could not be found or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing and the ID of your requested Feature was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notmodifiable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notmodifiable.md
deleted file mode 100644
index dadc051..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:feature.notmodifiable",
-    "message": "The Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions to modify it (WRITE is required).",
-    "description": "Check if the ID of the Thing and the ID of your requested Feature was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notfound.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notfound.md
deleted file mode 100644
index f970ac6..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.properties.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:feature.properties.notfound",
-    "message": "The Properties of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' do not exist or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notmodifiable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notmodifiable.md
deleted file mode 100644
index 56878ed..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.properties.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:feature.properties.notmodifiable",
-    "message": "The Properties of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required).",
-    "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notfound.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notfound.md
deleted file mode 100644
index bc9ed32..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.property.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:feature.property.notfound",
-    "message": "The Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' does not exist or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing, the Feature ID and the key of your requested property was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notmodifiable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notmodifiable.md
deleted file mode 100644
index ed61cf3..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.property.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:feature.property.notmodifiable",
-    "message": "The Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions to modify it (WRITE is required).",
-    "description": "Check if the ID of the Thing, the Feature ID and the key of your requested property was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notfound.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notfound.md
deleted file mode 100644
index 803f86d..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:features.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:features.notfound",
-    "message": "The Features on the Thing with ID 'com.acme:xdk_53' do not exist or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notmodifiable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notmodifiable.md
deleted file mode 100644
index 14774e4..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:features.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:features.notmodifiable",
-    "message": "The Features on the Thing with ID 'com.acme:xdk_53' cannot be modified as requester had insufficient permissions to modify it (WRITE is required).",
-    "description": "Check if the ID of the Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_id_invalid.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_id_invalid.md
deleted file mode 100644
index ac0cf4e..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_id_invalid.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## things:id.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:id.invalid",
-    "message": "Thing ID 'invalid id' is not valid!",
-    "description": "It must conform to the namespaced entity ID notation (see Ditto documentation)",
-    "url": "https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id"
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_id_notsettable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_id_notsettable.md
deleted file mode 100644
index 249138d..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_id_notsettable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:id.notsettable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:id.notsettable",
-    "message": "The Thing ID in the request body is not equal to the Thing ID in the request URL.",
-    "description": "Either delete the Thing ID from the request body or use the same Thing ID as in the request URL."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notallowed.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notallowed.md
deleted file mode 100644
index 19f9912..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notallowed.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:policyId.notallowed
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:policyId.notallowed",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be modified as it contained an inline Policy with an ID or a Policy ID and a Policy",
-    "description": "If you want to use an existing Policy, specify it as 'policyId' in the Thing JSON. If you want to create a Thing with inline Policy, no Policy ID is allowed as it will be created with the Thing ID."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notmodifiable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notmodifiable.md
deleted file mode 100644
index db3aa6a..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:policyId.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:policyId.notmodifiable",
-    "message": "The Policy ID of the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required).",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_policy_notallowed.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_policy_notallowed.md
deleted file mode 100644
index 6cde066..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_policy_notallowed.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:policy.notallowed
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:policy.notallowed",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be modified as it contained an inline Policy",
-    "description": "Once a Thing with inline Policy is created it can't be modified with another Policy. Use the Policy resources to modify the existing Policy."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_conflict.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_conflict.md
deleted file mode 100644
index c02db3a..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_conflict.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.conflict
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 409,
-    "error": "things:thing.conflict",
-    "message": "The Thing with ID 'com.acme:xdk_53' already exists",
-    "description": "Choose another Thing ID"
-  },
-  "status": 409
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notcreatable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notcreatable.md
deleted file mode 100644
index 1d54531..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notcreatable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.notcreatable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:thing.notcreatable",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be created as the Policy with ID 'com.acme:the_policy_id' is not existing.",
-    "description": "Check if the ID of the Policy you created the Thing with is correct and that the Policy is existing."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notdeletable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notdeletable.md
deleted file mode 100644
index df116c7..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notdeletable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.notdeletable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:thing.notdeletable",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be deleted as the requester had insufficient permissions ( WRITE on root resource is required).",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notfound.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notfound.md
deleted file mode 100644
index 7c76380..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:thing.notfound",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notmodifiable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notmodifiable.md
deleted file mode 100644
index 1f6d44c..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:thing.notmodifiable",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required).",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_toomanymodifyingrequests.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_toomanymodifyingrequests.md
deleted file mode 100644
index 901e379..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_toomanymodifyingrequests.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.toomanymodifyingrequests
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 429,
-    "error": "things:thing.toomanymodifyingrequests",
-    "message": "Too many modifying requests are already outstanding to the Thing with ID 'com.acme:xdk_53'.",
-    "description": "Throttle your modifying requests to the Thing or re-structure your Thing in multiple Things if you really need so many concurrent modifications."
-  },
-  "status": 429
-}
-```
diff --git a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_unavailable.md b/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_unavailable.md
deleted file mode 100644
index 0d7f852..0000000
--- a/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_unavailable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.unavailable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 503,
-    "error": "things:thing.unavailable",
-    "message": "The Thing with ID 'com.acme:xdk_53' is not available, please try again later.",
-    "description": "The requested Thing is temporarily not available."
-  },
-  "status": 503
-}
-```
diff --git a/pages/ditto/protocol/gateway/exceptions/gateway_authentication_failed.md b/pages/ditto/protocol/gateway/exceptions/gateway_authentication_failed.md
deleted file mode 100644
index 0dd5d6f..0000000
--- a/pages/ditto/protocol/gateway/exceptions/gateway_authentication_failed.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## gateway:authentication.failed
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 401,
-    "error": "gateway:authentication.failed",
-    "message": "devops authentication failed!",
-    "description": "Check if your credentials were correct."
-  },
-  "status": 401
-}
-```
diff --git a/pages/ditto/protocol/gateway/exceptions/gateway_authentication_provider_unavailable.md b/pages/ditto/protocol/gateway/exceptions/gateway_authentication_provider_unavailable.md
deleted file mode 100644
index ad479df..0000000
--- a/pages/ditto/protocol/gateway/exceptions/gateway_authentication_provider_unavailable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## gateway:authentication.provider.unavailable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 503,
-    "error": "gateway:authentication.provider.unavailable",
-    "message": "The authentication provider is not available.",
-    "description": "If after retry it is still unavailable, please contact the service team."
-  },
-  "status": 503
-}
-```
diff --git a/pages/ditto/protocol/gateway/exceptions/gateway_internalerror.md b/pages/ditto/protocol/gateway/exceptions/gateway_internalerror.md
deleted file mode 100644
index 4ffe209..0000000
--- a/pages/ditto/protocol/gateway/exceptions/gateway_internalerror.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## gateway:internalerror
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 500,
-    "error": "gateway:internalerror",
-    "message": "There was a rare case of an unexpected internal error.",
-    "description": "Please contact the service team."
-  },
-  "status": 500
-}
-```
diff --git a/pages/ditto/protocol/gateway/exceptions/gateway_method_notallowed.md b/pages/ditto/protocol/gateway/exceptions/gateway_method_notallowed.md
deleted file mode 100644
index 352d23c..0000000
--- a/pages/ditto/protocol/gateway/exceptions/gateway_method_notallowed.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## gateway:method.notallowed
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 405,
-    "error": "gateway:method.notallowed",
-    "message": "The provided HTTP method 'POST' is not allowed on this resource.",
-    "description": "Check if you used the correct resource and method combination."
-  },
-  "status": 405
-}
-```
diff --git a/pages/ditto/protocol/gateway/exceptions/gateway_service_timeout.md b/pages/ditto/protocol/gateway/exceptions/gateway_service_timeout.md
deleted file mode 100644
index af00478..0000000
--- a/pages/ditto/protocol/gateway/exceptions/gateway_service_timeout.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## gateway:service.timeout
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 504,
-    "error": "gateway:service.timeout",
-    "message": "The service you wanted to reach is currently not responding.",
-    "description": "Please contact the service team if this happens again."
-  },
-  "status": 504
-}
-```
diff --git a/pages/ditto/protocol/gateway/exceptions/gateway_service_unavailable.md b/pages/ditto/protocol/gateway/exceptions/gateway_service_unavailable.md
deleted file mode 100644
index 905de16..0000000
--- a/pages/ditto/protocol/gateway/exceptions/gateway_service_unavailable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## gateway:service.unavailable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 503,
-    "error": "gateway:service.unavailable",
-    "message": "The service you wanted to reach is currently not available.",
-    "description": "Please contact the service team if this happens again."
-  },
-  "status": 503
-}
-```
diff --git a/pages/ditto/protocol/gateway/exceptions/gateway_too_many_requests.md b/pages/ditto/protocol/gateway/exceptions/gateway_too_many_requests.md
deleted file mode 100644
index cc39f35..0000000
--- a/pages/ditto/protocol/gateway/exceptions/gateway_too_many_requests.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## gateway:too.many.requests
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 429,
-    "error": "gateway:too.many.requests",
-    "message": "Your Solution is temporarily blocked. Please try again in a few minutes.",
-    "description": "You have sent too many requests at once. Please wait before trying again."
-  },
-  "status": 429
-}
-```
diff --git a/pages/ditto/protocol/json/exceptions/json_field_missing.md b/pages/ditto/protocol/json/exceptions/json_field_missing.md
deleted file mode 100644
index 3691ed2..0000000
--- a/pages/ditto/protocol/json/exceptions/json_field_missing.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## json.field.missing
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "json.field.missing",
-    "message": "JSON did not include required <attributes> field!",
-    "description": "Check if all required JSON fields were set."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/json/exceptions/json_fieldselector_invalid.md b/pages/ditto/protocol/json/exceptions/json_fieldselector_invalid.md
deleted file mode 100644
index 7bec7cd..0000000
--- a/pages/ditto/protocol/json/exceptions/json_fieldselector_invalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## json.fieldselector.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "json.fieldselector.invalid",
-    "message": "The field selector <foo(bar> is invalid!",
-    "description": "Check, for example, if the amount of opening parentheses '(' matches the amount of closing ones ')'."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/json/exceptions/json_invalid.md b/pages/ditto/protocol/json/exceptions/json_invalid.md
deleted file mode 100644
index 9cbfbce..0000000
--- a/pages/ditto/protocol/json/exceptions/json_invalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## json.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "json.invalid",
-    "message": "Could not read 'foo'",
-    "description": "Check if the JSON was valid (e.g. on http://jsonlint.com) and if it was in required format."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/json/exceptions/json_pointer_invalid.md b/pages/ditto/protocol/json/exceptions/json_pointer_invalid.md
deleted file mode 100644
index 5ec2b73..0000000
--- a/pages/ditto/protocol/json/exceptions/json_pointer_invalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## json.pointer.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "json.pointer.invalid",
-    "message": "The JSON pointer <> is invalid!",
-    "description": "Check, for example, if the JSON Pointer is not empty."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/messages/exceptions/messages_message_timeout.md b/pages/ditto/protocol/messages/exceptions/messages_message_timeout.md
deleted file mode 100644
index 0ff3f4b..0000000
--- a/pages/ditto/protocol/messages/exceptions/messages_message_timeout.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## messages:message.timeout
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 408,
-    "error": "messages:message.timeout",
-    "message": "The Message reached the specified timeout of 60 seconds.",
-    "description": "Try increasing the Message timeout or ensure that the recipient of the Message responds in time."
-  },
-  "status": 408
-}
-```
diff --git a/pages/ditto/protocol/messages/exceptions/messages_subject_invalid.md b/pages/ditto/protocol/messages/exceptions/messages_subject_invalid.md
deleted file mode 100644
index 88e6199..0000000
--- a/pages/ditto/protocol/messages/exceptions/messages_subject_invalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## messages:subject.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "messages:subject.invalid",
-    "message": "Subject 'invalid subject' is not valid!",
-    "description": "It must not be empty and conform to RFC-3986 (URI) - check here if it does (select 'path' in the list): http://www.websitedev.de/temp/rfc3986-check.html.gz"
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/messages/exceptions/messages_timeout_invalid.md b/pages/ditto/protocol/messages/exceptions/messages_timeout_invalid.md
deleted file mode 100644
index 468e79a..0000000
--- a/pages/ditto/protocol/messages/exceptions/messages_timeout_invalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## messages:timeout.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "messages:timeout.invalid",
-    "message": "Timeout 120 seconds is not inside its allowed bounds 0 - 60 seconds!",
-    "description": "Choose a timeout inside the bounds."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_entry_invalid.md b/pages/ditto/protocol/policies/exceptions/policies_entry_invalid.md
deleted file mode 100644
index 46716a5..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_entry_invalid.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## policies:entry.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "policies:entry.invalid",
-    "message": "The Policy Entry is invalid."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_entry_modificationinvalid.md b/pages/ditto/protocol/policies/exceptions/policies_entry_modificationinvalid.md
deleted file mode 100644
index 8715fc8..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_entry_modificationinvalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:entry.modificationinvalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:entry.modificationinvalid",
-    "message": "The PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the resulting Policy would be invalid.",
-    "description": "There must always be at least one PolicyEntry with 'WRITE' permissions on resource 'policy:/'."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_entry_notfound.md b/pages/ditto/protocol/policies/exceptions/policies_entry_notfound.md
deleted file mode 100644
index c05340c..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_entry_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:entry.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:entry.notfound",
-    "message": "The PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Policy and the Label of your requested PolicyEntry was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_entry_notmodifiable.md b/pages/ditto/protocol/policies/exceptions/policies_entry_notmodifiable.md
deleted file mode 100644
index 904ed39..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_entry_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:entry.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:entry.notmodifiable",
-    "message": "The PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of the Policy and the Label of your requested PolicyEntry was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_id_invalid.md b/pages/ditto/protocol/policies/exceptions/policies_id_invalid.md
deleted file mode 100644
index 9e6720c..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_id_invalid.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## policies:id.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "policies:id.invalid",
-    "message": "Policy ID 'invalid id' is not valid!",
-    "description": "It must conform to the namespaced entity ID notation (see Ditto documentation)",
-    "url": "https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id"
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_policy_conflict.md b/pages/ditto/protocol/policies/exceptions/policies_policy_conflict.md
deleted file mode 100644
index f06377f..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_policy_conflict.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:policy.conflict
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 409,
-    "error": "policies:policy.conflict",
-    "message": "The Policy with ID 'com.acme:the_policy_id' already exists",
-    "description": "Choose another Policy ID"
-  },
-  "status": 409
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_policy_modificationinvalid.md b/pages/ditto/protocol/policies/exceptions/policies_policy_modificationinvalid.md
deleted file mode 100644
index 9ba0b15..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_policy_modificationinvalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:policy.modificationinvalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:policy.modificationinvalid",
-    "message": "The Policy with ID 'com.acme:the_policy_id' could not be modified as the resulting Policy would be invalid.",
-    "description": "There must always be at least one PolicyEntry with 'WRITE' permissions on resource 'policy:/'."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_policy_notfound.md b/pages/ditto/protocol/policies/exceptions/policies_policy_notfound.md
deleted file mode 100644
index de06584..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_policy_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:policy.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:policy.notfound",
-    "message": "The Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of your requested Policy was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_policy_notmodifiable.md b/pages/ditto/protocol/policies/exceptions/policies_policy_notmodifiable.md
deleted file mode 100644
index 8787587..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_policy_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:policy.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:policy.notmodifiable",
-    "message": "The Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of your requested Policy was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_policy_toomanymodifyingrequests.md b/pages/ditto/protocol/policies/exceptions/policies_policy_toomanymodifyingrequests.md
deleted file mode 100644
index 692535a..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_policy_toomanymodifyingrequests.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:policy.toomanymodifyingrequests
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 429,
-    "error": "policies:policy.toomanymodifyingrequests",
-    "message": "Too many modifying requests are already outstanding to the Policy with ID 'com.acme:the_policy_id'.",
-    "description": "Throttle your modifying requests to the Policy or re-structure your Policy in multiple Policies if you really need so many concurrent modifications."
-  },
-  "status": 429
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_policy_unavailable.md b/pages/ditto/protocol/policies/exceptions/policies_policy_unavailable.md
deleted file mode 100644
index d461452..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_policy_unavailable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:policy.unavailable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 503,
-    "error": "policies:policy.unavailable",
-    "message": "The Policy with ID 'com.acme:the_policy_id' is not available, please try again later.",
-    "description": "The requested Policy is temporarily not available."
-  },
-  "status": 503
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_resource_notfound.md b/pages/ditto/protocol/policies/exceptions/policies_resource_notfound.md
deleted file mode 100644
index d446e8c..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_resource_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:resource.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:resource.notfound",
-    "message": "The Resource '/the_resource_path' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Policy, the Label of the PolicyEntry and the path of your requested Resource was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_resource_notmodifiable.md b/pages/ditto/protocol/policies/exceptions/policies_resource_notmodifiable.md
deleted file mode 100644
index 7392627..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_resource_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:resource.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:resource.notmodifiable",
-    "message": "The Resource '/the_resource_path' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of the Policy, the Label of the PolicyEntry and the path of your requested Resource was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_resources_notfound.md b/pages/ditto/protocol/policies/exceptions/policies_resources_notfound.md
deleted file mode 100644
index 4205989..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_resources_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:resources.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:resources.notfound",
-    "message": "The Resources of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Policy and the Label of the PolicyEntry was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_resources_notmodifiable.md b/pages/ditto/protocol/policies/exceptions/policies_resources_notmodifiable.md
deleted file mode 100644
index 822b01c..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_resources_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:resources.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:resources.notmodifiable",
-    "message": "The Resources of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of the Policy and the PolicyEntry's Label of your requested Resources was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_subject_notfound.md b/pages/ditto/protocol/policies/exceptions/policies_subject_notfound.md
deleted file mode 100644
index 0b60934..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_subject_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:subject.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:subject.notfound",
-    "message": "The Subject with ID 'google:the_subjectid' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Policy, the Label of the PolicyEntry and ID of your requested Subject was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_subject_notmodifiable.md b/pages/ditto/protocol/policies/exceptions/policies_subject_notmodifiable.md
deleted file mode 100644
index 827f3cf..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_subject_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:subject.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:subject.notmodifiable",
-    "message": "The Subject with ID 'google:the_subjectid' of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of the Policy, the Label of the PolicyEntry and ID of your requested Subject was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_subjectid_invalid.md b/pages/ditto/protocol/policies/exceptions/policies_subjectid_invalid.md
deleted file mode 100644
index 35171a7..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_subjectid_invalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:subjectid.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "policies:subjectid.invalid",
-    "message": "Subject ID 'invalid subject' is not valid!",
-    "description": "It must contain an issuer as prefix separated by a colon ':' from the actual subject"
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_subjects_notfound.md b/pages/ditto/protocol/policies/exceptions/policies_subjects_notfound.md
deleted file mode 100644
index 1876017..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_subjects_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:subjects.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "policies:subjects.notfound",
-    "message": "The Subjects of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Policy and the Label of the PolicyEntry was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/policies/exceptions/policies_subjects_notmodifiable.md b/pages/ditto/protocol/policies/exceptions/policies_subjects_notmodifiable.md
deleted file mode 100644
index 8da0ab2..0000000
--- a/pages/ditto/protocol/policies/exceptions/policies_subjects_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## policies:subjects.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "policies:subjects.notmodifiable",
-    "message": "The Subjects of the PolicyEntry with Label 'the_label' on the Policy with ID 'com.acme:the_policy_id' could not be modified as the requester had insufficient permissions.",
-    "description": "Check if the ID of the Policy and the PolicyEntry's Label of your requested Subjects was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/search/exceptions/thing-search_search_filter_invalid.md b/pages/ditto/protocol/search/exceptions/thing-search_search_filter_invalid.md
deleted file mode 100644
index 9d1019b..0000000
--- a/pages/ditto/protocol/search/exceptions/thing-search_search_filter_invalid.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## thing-search:search.filter.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "thing-search:search.filter.invalid",
-    "description": "The provided filter is invalid."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/search/exceptions/thing-search_search_option_invalid.md b/pages/ditto/protocol/search/exceptions/thing-search_search_option_invalid.md
deleted file mode 100644
index 644c6e7..0000000
--- a/pages/ditto/protocol/search/exceptions/thing-search_search_option_invalid.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## thing-search:search.option.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "thing-search:search.option.invalid",
-    "description": "At least one provided option is invalid."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/creatething.md b/pages/ditto/protocol/things/commands/modify/creatething.md
deleted file mode 100644
index efc7daf..0000000
--- a/pages/ditto/protocol/things/commands/modify/creatething.md
+++ /dev/null
@@ -1,32 +0,0 @@
-## CreateThing
-
-Creates a new Thing with ID ``com.acme:xdk_53`` that uses an existing Policy with ID ``com.acme:the_policy_id``.
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/create",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "definition": "com.acme:XDKmodel:1.0.0",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/createthingalternatives.md b/pages/ditto/protocol/things/commands/modify/createthingalternatives.md
deleted file mode 100644
index d14a0af..0000000
--- a/pages/ditto/protocol/things/commands/modify/createthingalternatives.md
+++ /dev/null
@@ -1,38 +0,0 @@
-## Alternative CreateThing commands
-
-If you want to copy an existing Policy instead of creating a new one by yourself or reference an existing Policy, you
-can adjust the CreateThing command like demonstrated in the following examples.
-
-### CreateThing with copied Policy by Policy ID
-
-Creates a new Thing with ID ``com.acme:xdk_53`` with a Policy copied from the Policy with ID ``com.acme:the_policy_id_to_copy``.
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/create",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "_copyPolicyFrom": "com:acme:the_policy_id_to_copy"
-  }
-}
-```
-
-### CreateThing with copied Policy by Thing reference
-
-Creates a new Thing with ID ``com.acme:xdk_53`` with a Policy copied from a Thing with ID ``com.acme:xdk_52``.
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/create",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "_copyPolicyFrom": "{% raw %}{{ ref:things/com:acme:xdk_52/policyId }}{% endraw %}"
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/createthingresponse.md b/pages/ditto/protocol/things/commands/modify/createthingresponse.md
deleted file mode 100644
index c9c49fa..0000000
--- a/pages/ditto/protocol/things/commands/modify/createthingresponse.md
+++ /dev/null
@@ -1,31 +0,0 @@
-## CreateThingResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/create",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "definition": "com.acme:XDKmodel:1.0.0",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deleteaclentry.md b/pages/ditto/protocol/things/commands/modify/deleteaclentry.md
deleted file mode 100644
index d5e2300..0000000
--- a/pages/ditto/protocol/things/commands/modify/deleteaclentry.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteAclEntry
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/acl/the_auth_subject"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deleteattribute.md b/pages/ditto/protocol/things/commands/modify/deleteattribute.md
deleted file mode 100644
index 9c8e5bf..0000000
--- a/pages/ditto/protocol/things/commands/modify/deleteattribute.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteAttribute
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/attributes/location"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deleteattributeresponse.md b/pages/ditto/protocol/things/commands/modify/deleteattributeresponse.md
deleted file mode 100644
index 5fd4add..0000000
--- a/pages/ditto/protocol/things/commands/modify/deleteattributeresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteAttributeResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/attributes/location",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deleteattributes.md b/pages/ditto/protocol/things/commands/modify/deleteattributes.md
deleted file mode 100644
index 7943ad0..0000000
--- a/pages/ditto/protocol/things/commands/modify/deleteattributes.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteAttributes
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/attributes"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deleteattributesresponse.md b/pages/ditto/protocol/things/commands/modify/deleteattributesresponse.md
deleted file mode 100644
index 8231231..0000000
--- a/pages/ditto/protocol/things/commands/modify/deleteattributesresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteAttributesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/attributes",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletefeature.md b/pages/ditto/protocol/things/commands/modify/deletefeature.md
deleted file mode 100644
index a29caf0..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletefeature.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteFeature
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletefeaturedefinition.md b/pages/ditto/protocol/things/commands/modify/deletefeaturedefinition.md
deleted file mode 100644
index ff0edda..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletefeaturedefinition.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteFeatureDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/definition"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletefeaturedefinitionresponse.md b/pages/ditto/protocol/things/commands/modify/deletefeaturedefinitionresponse.md
deleted file mode 100644
index decd88e..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletefeaturedefinitionresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteFeatureDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletefeatureproperties.md b/pages/ditto/protocol/things/commands/modify/deletefeatureproperties.md
deleted file mode 100644
index ccc9565..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletefeatureproperties.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteFeatureProperties
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/properties"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletefeaturepropertiesresponse.md b/pages/ditto/protocol/things/commands/modify/deletefeaturepropertiesresponse.md
deleted file mode 100644
index f4fe6ad..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletefeaturepropertiesresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteFeaturePropertiesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletefeatureproperty.md b/pages/ditto/protocol/things/commands/modify/deletefeatureproperty.md
deleted file mode 100644
index 4d1edc6..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletefeatureproperty.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteFeatureProperty
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletefeaturepropertyresponse.md b/pages/ditto/protocol/things/commands/modify/deletefeaturepropertyresponse.md
deleted file mode 100644
index cbd699d..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletefeaturepropertyresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteFeaturePropertyResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletefeatureresponse.md b/pages/ditto/protocol/things/commands/modify/deletefeatureresponse.md
deleted file mode 100644
index 51b8638..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletefeatureresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteFeatureResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletefeatures.md b/pages/ditto/protocol/things/commands/modify/deletefeatures.md
deleted file mode 100644
index b84efe8..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletefeatures.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteFeatures
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletefeaturesresponse.md b/pages/ditto/protocol/things/commands/modify/deletefeaturesresponse.md
deleted file mode 100644
index 423f5e3..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletefeaturesresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteFeaturesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/features",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletething.md b/pages/ditto/protocol/things/commands/modify/deletething.md
deleted file mode 100644
index f195323..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletething.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteThing
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/deletethingdefinition.md b/pages/ditto/protocol/things/commands/modify/deletethingdefinition.md
deleted file mode 100644
index e555a5a..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletethingdefinition.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## DeleteThingDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/definition"
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/things/commands/modify/deletethingdefinitionresponse.md b/pages/ditto/protocol/things/commands/modify/deletethingdefinitionresponse.md
deleted file mode 100644
index 17771eb..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletethingdefinitionresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteThingDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/definition",
-  "status": 204
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/things/commands/modify/deletethingresponse.md b/pages/ditto/protocol/things/commands/modify/deletethingresponse.md
deleted file mode 100644
index d06086a..0000000
--- a/pages/ditto/protocol/things/commands/modify/deletethingresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DeleteThingResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/delete",
-  "headers": {},
-  "path": "/",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyacl.md b/pages/ditto/protocol/things/commands/modify/modifyacl.md
deleted file mode 100644
index b50326e..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyacl.md
+++ /dev/null
@@ -1,21 +0,0 @@
-## ModifyAcl
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/acl",
-  "value": {
-    "the_auth_subject_2": {
-      "READ": true,
-      "WRITE": false,
-      "ADMINISTRATE": false
-    },
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyaclentry.md b/pages/ditto/protocol/things/commands/modify/modifyaclentry.md
deleted file mode 100644
index d7faaa5..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyaclentry.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## ModifyAclEntry
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/acl/the_auth_subject",
-  "value": {
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyattribute.md b/pages/ditto/protocol/things/commands/modify/modifyattribute.md
deleted file mode 100644
index 7a1a956..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyattribute.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## ModifyAttribute
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes/location",
-  "value": {
-    "latitude": 44.673856,
-    "longitude": 8.261719
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyattributeresponse.md b/pages/ditto/protocol/things/commands/modify/modifyattributeresponse.md
deleted file mode 100644
index 372a011..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyattributeresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyAttributeResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes/location",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyattributeresponsecreated.md b/pages/ditto/protocol/things/commands/modify/modifyattributeresponsecreated.md
deleted file mode 100644
index aef0cd1..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyattributeresponsecreated.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## ModifyAttributeResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes/location",
-  "value": {
-    "latitude": 44.673856,
-    "longitude": 8.261719
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyattributes.md b/pages/ditto/protocol/things/commands/modify/modifyattributes.md
deleted file mode 100644
index 8817bea..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyattributes.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## ModifyAttributes
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes",
-  "value": {
-    "location": {
-      "latitude": 44.673856,
-      "longitude": 8.261719
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyattributesresponse.md b/pages/ditto/protocol/things/commands/modify/modifyattributesresponse.md
deleted file mode 100644
index 5270496..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyattributesresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyAttributesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes",
-  "value": null,
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyattributesresponsecreated.md b/pages/ditto/protocol/things/commands/modify/modifyattributesresponsecreated.md
deleted file mode 100644
index 01c5fb6..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyattributesresponsecreated.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## ModifyAttributesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/attributes",
-  "value": {
-    "location": {
-      "latitude": 44.673856,
-      "longitude": 8.261719
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeature.md b/pages/ditto/protocol/things/commands/modify/modifyfeature.md
deleted file mode 100644
index 7c271df..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeature.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## ModifyFeature
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": {
-    "properties": {
-      "x": 3.141,
-      "y": 2.718,
-      "z": 1,
-      "unit": "g"
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeaturedefinition.md b/pages/ditto/protocol/things/commands/modify/modifyfeaturedefinition.md
deleted file mode 100644
index 6394dec..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeaturedefinition.md
+++ /dev/null
@@ -1,12 +0,0 @@
-## ModifyFeatureDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "value": [
-    "com.acme:accelerometer:1.0.0"
-  ]
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeaturedefinitionresponse.md b/pages/ditto/protocol/things/commands/modify/modifyfeaturedefinitionresponse.md
deleted file mode 100644
index 4a1d67d..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeaturedefinitionresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyFeatureDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeaturedefinitionresponsecreated.md b/pages/ditto/protocol/things/commands/modify/modifyfeaturedefinitionresponsecreated.md
deleted file mode 100644
index 63e8809..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeaturedefinitionresponsecreated.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## ModifyFeatureDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "value": [
-    "com.acme:accelerometer:1.0.0"
-  ],
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeatureproperties.md b/pages/ditto/protocol/things/commands/modify/modifyfeatureproperties.md
deleted file mode 100644
index dee3d4e..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeatureproperties.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## ModifyFeatureProperties
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "value": {
-    "x": 3.141,
-    "y": 2.718,
-    "z": 1,
-    "unit": "g"
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertiesresponse.md b/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertiesresponse.md
deleted file mode 100644
index 6ba2774..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertiesresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyFeaturePropertiesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertiesresponsecreated.md b/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertiesresponsecreated.md
deleted file mode 100644
index 348c2af..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertiesresponsecreated.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## ModifyFeaturePropertiesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "value": {
-    "x": 3.141,
-    "y": 2.718,
-    "z": 1,
-    "unit": "g"
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeatureproperty.md b/pages/ditto/protocol/things/commands/modify/modifyfeatureproperty.md
deleted file mode 100644
index f1c19f0..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeatureproperty.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyFeatureProperty
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "value": 42
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertyresponse.md b/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertyresponse.md
deleted file mode 100644
index 909beb2..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertyresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyFeaturePropertyResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertyresponsecreated.md b/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertyresponsecreated.md
deleted file mode 100644
index 2ef2815..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeaturepropertyresponsecreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyFeaturePropertyResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "value": 42,
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeatureresponse.md b/pages/ditto/protocol/things/commands/modify/modifyfeatureresponse.md
deleted file mode 100644
index b217b28..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeatureresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyFeatureResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": null,
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeatureresponsecreated.md b/pages/ditto/protocol/things/commands/modify/modifyfeatureresponsecreated.md
deleted file mode 100644
index 525eb5e..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeatureresponsecreated.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## ModifyFeatureResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": {
-    "properties": {
-      "x": 3.141,
-      "y": 2.718,
-      "z": 1,
-      "unit": "g"
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeatures.md b/pages/ditto/protocol/things/commands/modify/modifyfeatures.md
deleted file mode 100644
index 2fc678e..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeatures.md
+++ /dev/null
@@ -1,19 +0,0 @@
-## ModifyFeatures
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features",
-  "value": {
-    "accelerometer": {
-      "properties": {
-        "x": 3.141,
-        "y": 2.718,
-        "z": 1,
-        "unit": "g"
-      }
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeaturesresponse.md b/pages/ditto/protocol/things/commands/modify/modifyfeaturesresponse.md
deleted file mode 100644
index e519ae7..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeaturesresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyFeaturesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features",
-  "value": null,
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifyfeaturesresponsecreated.md b/pages/ditto/protocol/things/commands/modify/modifyfeaturesresponsecreated.md
deleted file mode 100644
index 8f1cd40..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifyfeaturesresponsecreated.md
+++ /dev/null
@@ -1,20 +0,0 @@
-## ModifyFeaturesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/features",
-  "value": {
-    "accelerometer": {
-      "properties": {
-        "x": 3.141,
-        "y": 2.718,
-        "z": 1,
-        "unit": "g"
-      }
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifypolicyid.md b/pages/ditto/protocol/things/commands/modify/modifypolicyid.md
deleted file mode 100644
index d10de0a..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifypolicyid.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyPolicyId
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/policyId",
-  "value": "com.acme:the_policy_id"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifypolicyidresponsecreated.md b/pages/ditto/protocol/things/commands/modify/modifypolicyidresponsecreated.md
deleted file mode 100644
index 62d5c5c..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifypolicyidresponsecreated.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyPolicyIdResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/policyId",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifypolicyidresponsemodified.md b/pages/ditto/protocol/things/commands/modify/modifypolicyidresponsemodified.md
deleted file mode 100644
index 62d5c5c..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifypolicyidresponsemodified.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyPolicyIdResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/policyId",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifything.md b/pages/ditto/protocol/things/commands/modify/modifything.md
deleted file mode 100644
index a115641..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifything.md
+++ /dev/null
@@ -1,30 +0,0 @@
-## ModifyThing
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "definition": "com.acme:XDKmodel:1.0.0",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifythingalternatives.md b/pages/ditto/protocol/things/commands/modify/modifythingalternatives.md
deleted file mode 100644
index 9f5176d..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifythingalternatives.md
+++ /dev/null
@@ -1,42 +0,0 @@
-## Alternative ModifyThing commands
-
-If you want to copy an existing Policy instead of creating a new one by yourself or reference an existing Policy, you
-can adjust the ModifyThing command like demonstrated in the following examples.<br/>
-This only works if a Thing with the given ``thingId`` does not exist, yet. If it exists the ``_copyPolicyFrom`` field
-will be ignored.
-
-### ModifyThing with copied Policy by Policy ID
-
-If no Thing with ID ``com.acme:xdk_53`` exists, this command will create a new Thing with ID ``com.acme:xdk_53`` with a
-Policy copied from the Policy with ID ``com.acme:the_policy_id_to_copy``.
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "_copyPolicyFrom": "com:acme:the_policy_id_to_copy"
-  }
-}
-```
-
-### ModifyThing with copied Policy by Thing reference
-
-If no Thing with ID ``com.acme:xdk_53`` exists, this command will create a new Thing with ID ``com.acme:xdk_53`` with a
-Policy copied from a Thing with ID ``com.acme:xdk_52``.
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "_copyPolicyFrom": "{% raw %}{{ ref:things/com:acme:xdk_52/policyId }}{% endraw %}"
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifythingdefinition.md b/pages/ditto/protocol/things/commands/modify/modifythingdefinition.md
deleted file mode 100644
index a83a519..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifythingdefinition.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyThingDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/definition",
-  "value": "digitaltwin:DigitaltwinExample:1.0.0"
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/things/commands/modify/modifythingdefinitionresponse.md b/pages/ditto/protocol/things/commands/modify/modifythingdefinitionresponse.md
deleted file mode 100644
index d1c9a54..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifythingdefinitionresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyThingDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/definition",
-  "status": 204
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/things/commands/modify/modifythingdefinitionresponsecreated.md b/pages/ditto/protocol/things/commands/modify/modifythingdefinitionresponsecreated.md
deleted file mode 100644
index b4019d0..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifythingdefinitionresponsecreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## ModifyThingDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/definition",
-  "value": "digitaltwin:DigitaltwinExample:1.0.0",
-  "status": 201
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/things/commands/modify/modifythingresponse.md b/pages/ditto/protocol/things/commands/modify/modifythingresponse.md
deleted file mode 100644
index 33ebfef..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifythingresponse.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ModifyThingResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/",
-  "status": 204
-}
-```
diff --git a/pages/ditto/protocol/things/commands/modify/modifythingresponsecreated.md b/pages/ditto/protocol/things/commands/modify/modifythingresponsecreated.md
deleted file mode 100644
index 3844752..0000000
--- a/pages/ditto/protocol/things/commands/modify/modifythingresponsecreated.md
+++ /dev/null
@@ -1,31 +0,0 @@
-## ModifyThingResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/modify",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "definition": "com.acme:XDKmodel:1.0.0",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  },
-  "status": 201
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrieveacl.md b/pages/ditto/protocol/things/commands/query/retrieveacl.md
deleted file mode 100644
index 1cfe713..0000000
--- a/pages/ditto/protocol/things/commands/query/retrieveacl.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveAcl
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/acl"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrieveaclentry.md b/pages/ditto/protocol/things/commands/query/retrieveaclentry.md
deleted file mode 100644
index 817303b..0000000
--- a/pages/ditto/protocol/things/commands/query/retrieveaclentry.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveAclEntry
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/acl/the_auth_subject"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrieveaclentryresponse.md b/pages/ditto/protocol/things/commands/query/retrieveaclentryresponse.md
deleted file mode 100644
index 51c4c09..0000000
--- a/pages/ditto/protocol/things/commands/query/retrieveaclentryresponse.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## RetrieveAclEntryResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/acl/the_auth_subject",
-  "value": {
-    "READ": true,
-    "WRITE": true,
-    "ADMINISTRATE": true
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrieveaclresponse.md b/pages/ditto/protocol/things/commands/query/retrieveaclresponse.md
deleted file mode 100644
index eb64f76..0000000
--- a/pages/ditto/protocol/things/commands/query/retrieveaclresponse.md
+++ /dev/null
@@ -1,22 +0,0 @@
-## RetrieveAclResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/acl",
-  "value": {
-    "the_auth_subject_2": {
-      "READ": true,
-      "WRITE": false,
-      "ADMINISTRATE": false
-    },
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrieveattribute.md b/pages/ditto/protocol/things/commands/query/retrieveattribute.md
deleted file mode 100644
index 0898d1d..0000000
--- a/pages/ditto/protocol/things/commands/query/retrieveattribute.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveAttribute
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/attributes/location"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrieveattributeresponse.md b/pages/ditto/protocol/things/commands/query/retrieveattributeresponse.md
deleted file mode 100644
index ad9b6d4..0000000
--- a/pages/ditto/protocol/things/commands/query/retrieveattributeresponse.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## RetrieveAttributeResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/attributes/location",
-  "value": {
-    "latitude": 44.673856,
-    "longitude": 8.261719
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrieveattributes-selectedfields.md b/pages/ditto/protocol/things/commands/query/retrieveattributes-selectedfields.md
deleted file mode 100644
index 5d7b5b1..0000000
--- a/pages/ditto/protocol/things/commands/query/retrieveattributes-selectedfields.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## RetrieveAttributes
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/attributes",
-  "fields": "attributes"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrieveattributes.md b/pages/ditto/protocol/things/commands/query/retrieveattributes.md
deleted file mode 100644
index 586875e..0000000
--- a/pages/ditto/protocol/things/commands/query/retrieveattributes.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveAttributes
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/attributes"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrieveattributesresponse.md b/pages/ditto/protocol/things/commands/query/retrieveattributesresponse.md
deleted file mode 100644
index d918839..0000000
--- a/pages/ditto/protocol/things/commands/query/retrieveattributesresponse.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## RetrieveAttributesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/attributes",
-  "value": {
-    "location": {
-      "latitude": 44.673856,
-      "longitude": 8.261719
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeature.md b/pages/ditto/protocol/things/commands/query/retrievefeature.md
deleted file mode 100644
index 2222d92..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeature.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveFeature
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeaturedefinition.md b/pages/ditto/protocol/things/commands/query/retrievefeaturedefinition.md
deleted file mode 100644
index aa71318..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeaturedefinition.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveFeatureDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/definition"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeaturedefinitionresponse.md b/pages/ditto/protocol/things/commands/query/retrievefeaturedefinitionresponse.md
deleted file mode 100644
index b986bb3..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeaturedefinitionresponse.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## RetrieveFeatureDefinitionResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "value": [
-    "com.acme:accelerometer:1.0.0"
-  ],
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeatureproperties-selectedfields.md b/pages/ditto/protocol/things/commands/query/retrievefeatureproperties-selectedfields.md
deleted file mode 100644
index 88b8247..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeatureproperties-selectedfields.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## RetrieveFeatureProperties
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "fields": "properties/target_year_1"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeatureproperties.md b/pages/ditto/protocol/things/commands/query/retrievefeatureproperties.md
deleted file mode 100644
index 5cf92be..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeatureproperties.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveFeatureProperties
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/properties"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeaturepropertiesresponse.md b/pages/ditto/protocol/things/commands/query/retrievefeaturepropertiesresponse.md
deleted file mode 100644
index 4e8e15d..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeaturepropertiesresponse.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## RetrieveFeaturePropertiesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "value": {
-    "x": 3.141,
-    "y": 2.718,
-    "z": 1,
-    "unit": "g"
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeatureproperty.md b/pages/ditto/protocol/things/commands/query/retrievefeatureproperty.md
deleted file mode 100644
index ba82364..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeatureproperty.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveFeatureProperty
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeaturepropertyresponse.md b/pages/ditto/protocol/things/commands/query/retrievefeaturepropertyresponse.md
deleted file mode 100644
index 46ef144..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeaturepropertyresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrieveFeaturePropertyResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "value": 42,
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeatureresponse.md b/pages/ditto/protocol/things/commands/query/retrievefeatureresponse.md
deleted file mode 100644
index e26464b..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeatureresponse.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## RetrieveFeatureResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": {
-    "properties": {
-      "x": 3.141,
-      "y": 2.718,
-      "z": 1,
-      "unit": "g"
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeatures.md b/pages/ditto/protocol/things/commands/query/retrievefeatures.md
deleted file mode 100644
index 24a6ad3..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeatures.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveFeatures
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievefeaturesresponse.md b/pages/ditto/protocol/things/commands/query/retrievefeaturesresponse.md
deleted file mode 100644
index 212df08..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievefeaturesresponse.md
+++ /dev/null
@@ -1,20 +0,0 @@
-## RetrieveFeaturesResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/features",
-  "value": {
-    "accelerometer": {
-      "properties": {
-        "x": 3.141,
-        "y": 2.718,
-        "z": 1,
-        "unit": "g"
-      }
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievepolicyid.md b/pages/ditto/protocol/things/commands/query/retrievepolicyid.md
deleted file mode 100644
index c732577..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievepolicyid.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrievePolicyId
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/policyId"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievepolicyidresponse.md b/pages/ditto/protocol/things/commands/query/retrievepolicyidresponse.md
deleted file mode 100644
index 0cd6cf0..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievepolicyidresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrievePolicyIdResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/policyId",
-  "value": "com.acme:the_policy_id",
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievething-withfieldselector.md b/pages/ditto/protocol/things/commands/query/retrievething-withfieldselector.md
deleted file mode 100644
index fa8326b..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievething-withfieldselector.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## RetrieveThing
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/",
-  "fields": "thingId,attributes(location)"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievething-withsnapshotrevision.md b/pages/ditto/protocol/things/commands/query/retrievething-withsnapshotrevision.md
deleted file mode 100644
index f01ba77..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievething-withsnapshotrevision.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveThing
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievething.md b/pages/ditto/protocol/things/commands/query/retrievething.md
deleted file mode 100644
index f01ba77..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievething.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveThing
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievethingdefinition.md b/pages/ditto/protocol/things/commands/query/retrievethingdefinition.md
deleted file mode 100644
index d319cc4..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievethingdefinition.md
+++ /dev/null
@@ -1,9 +0,0 @@
-## RetrieveDefinition
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/definition"
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/things/commands/query/retrievethingdefinitionresponse.md b/pages/ditto/protocol/things/commands/query/retrievethingdefinitionresponse.md
deleted file mode 100644
index a5b8e17..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievethingdefinitionresponse.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## RetrieveAttributeResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/definition",
-  "value": "digitaltwin:DigitaltwinExample:1.0.0",
-  "status": 200
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/things/commands/query/retrievethingresponse.md b/pages/ditto/protocol/things/commands/query/retrievethingresponse.md
deleted file mode 100644
index 299c182..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievethingresponse.md
+++ /dev/null
@@ -1,30 +0,0 @@
-## RetrieveThingResponse
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  },
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievethings-withfieldselector.md b/pages/ditto/protocol/things/commands/query/retrievethings-withfieldselector.md
deleted file mode 100644
index 84adc59..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievethings-withfieldselector.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## RetrieveThings
-
-```json
-{
-  "topic": "_/_/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingIds": [
-      "com.acme:xdk_53",
-      "com.acme:xdk_58",
-      "com.acme:xdk_67"
-    ]
-  },
-  "fields": "thingId,attributes(location)"
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievethings.md b/pages/ditto/protocol/things/commands/query/retrievethings.md
deleted file mode 100644
index 22bba13..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievethings.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## RetrieveThings
-
-```json
-{
-  "topic": "_/_/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingIds": [
-      "com.acme:xdk_53",
-      "com.acme:xdk_58",
-      "com.acme:xdk_67"
-    ]
-  }
-}
-```
diff --git a/pages/ditto/protocol/things/commands/query/retrievethingsresponse.md b/pages/ditto/protocol/things/commands/query/retrievethingsresponse.md
deleted file mode 100644
index b574622..0000000
--- a/pages/ditto/protocol/things/commands/query/retrievethingsresponse.md
+++ /dev/null
@@ -1,30 +0,0 @@
-## RetrieveThingsResponse
-
-```json
-{
-  "topic": "com.acme/_/things/twin/commands/retrieve",
-  "headers": {},
-  "path": "/",
-  "value": [{
-      "thingId": "com.acme:xdk_53",
-      "policyId": "com.acme:the_policy_id",
-      "attributes": {
-        "location": {
-          "latitude": 44.673856,
-          "longitude": 8.261719
-        }
-      },
-      "features": {
-        "accelerometer": {
-          "properties": {
-            "x": 3.141,
-            "y": 2.718,
-            "z": 1,
-            "unit": "g"
-          }
-        }
-      }
-    }],
-  "status": 200
-}
-```
diff --git a/pages/ditto/protocol/things/events/aclentrycreated.md b/pages/ditto/protocol/things/events/aclentrycreated.md
deleted file mode 100644
index 9217d6d..0000000
--- a/pages/ditto/protocol/things/events/aclentrycreated.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## AclEntryCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/acl/the_auth_subject",
-  "value": {
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/aclentrydeleted.md b/pages/ditto/protocol/things/events/aclentrydeleted.md
deleted file mode 100644
index ceefb2e..0000000
--- a/pages/ditto/protocol/things/events/aclentrydeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## AclEntryDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/acl/the_auth_subject",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/aclentrymodified.md b/pages/ditto/protocol/things/events/aclentrymodified.md
deleted file mode 100644
index f1485b5..0000000
--- a/pages/ditto/protocol/things/events/aclentrymodified.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## AclEntryModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/acl/the_auth_subject",
-  "value": {
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/aclmodified.md b/pages/ditto/protocol/things/events/aclmodified.md
deleted file mode 100644
index e711b99..0000000
--- a/pages/ditto/protocol/things/events/aclmodified.md
+++ /dev/null
@@ -1,22 +0,0 @@
-## AclModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/acl",
-  "value": {
-    "the_auth_subject_2": {
-      "READ": true,
-      "WRITE": false,
-      "ADMINISTRATE": false
-    },
-    "the_auth_subject": {
-      "READ": true,
-      "WRITE": true,
-      "ADMINISTRATE": true
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/attributecreated.md b/pages/ditto/protocol/things/events/attributecreated.md
deleted file mode 100644
index da9ff3e..0000000
--- a/pages/ditto/protocol/things/events/attributecreated.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## AttributeCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/attributes/location",
-  "value": {
-    "latitude": 44.673856,
-    "longitude": 8.261719
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/attributedeleted.md b/pages/ditto/protocol/things/events/attributedeleted.md
deleted file mode 100644
index 38cf420..0000000
--- a/pages/ditto/protocol/things/events/attributedeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## AttributeDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/attributes/location",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/attributemodified.md b/pages/ditto/protocol/things/events/attributemodified.md
deleted file mode 100644
index 402ea9f..0000000
--- a/pages/ditto/protocol/things/events/attributemodified.md
+++ /dev/null
@@ -1,14 +0,0 @@
-## AttributeModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/attributes/location",
-  "value": {
-    "latitude": 44.673856,
-    "longitude": 8.261719
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/attributescreated.md b/pages/ditto/protocol/things/events/attributescreated.md
deleted file mode 100644
index 67c13f0..0000000
--- a/pages/ditto/protocol/things/events/attributescreated.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## AttributesCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/attributes",
-  "value": {
-    "location": {
-      "latitude": 44.673856,
-      "longitude": 8.261719
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/attributesdeleted.md b/pages/ditto/protocol/things/events/attributesdeleted.md
deleted file mode 100644
index e8b5ba7..0000000
--- a/pages/ditto/protocol/things/events/attributesdeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## AttributesDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/attributes",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/attributesmodified.md b/pages/ditto/protocol/things/events/attributesmodified.md
deleted file mode 100644
index 9f9303f..0000000
--- a/pages/ditto/protocol/things/events/attributesmodified.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## AttributesModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/attributes",
-  "value": {
-    "location": {
-      "latitude": 44.673856,
-      "longitude": 8.261719
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featurecreated.md b/pages/ditto/protocol/things/events/featurecreated.md
deleted file mode 100644
index 3460fa2..0000000
--- a/pages/ditto/protocol/things/events/featurecreated.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## FeatureCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": {
-    "properties": {
-      "x": 3.141,
-      "y": 2.718,
-      "z": 1,
-      "unit": "g"
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featuredefinitioncreated.md b/pages/ditto/protocol/things/events/featuredefinitioncreated.md
deleted file mode 100644
index bb30d85..0000000
--- a/pages/ditto/protocol/things/events/featuredefinitioncreated.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## FeatureDefinitionCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "value": [
-    "com.acme:accelerometer:1.0.0"
-  ],
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featuredefinitiondeleted.md b/pages/ditto/protocol/things/events/featuredefinitiondeleted.md
deleted file mode 100644
index 1c7fba5..0000000
--- a/pages/ditto/protocol/things/events/featuredefinitiondeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## FeatureDefinitionDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featuredefinitionmodified.md b/pages/ditto/protocol/things/events/featuredefinitionmodified.md
deleted file mode 100644
index 3e694d1..0000000
--- a/pages/ditto/protocol/things/events/featuredefinitionmodified.md
+++ /dev/null
@@ -1,13 +0,0 @@
-## FeatureDefinitionModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/features/accelerometer/definition",
-  "value": [
-    "com.acme:accelerometer:1.0.0"
-  ],
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featuredeleted.md b/pages/ditto/protocol/things/events/featuredeleted.md
deleted file mode 100644
index b490a8e..0000000
--- a/pages/ditto/protocol/things/events/featuredeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## FeatureDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featuremodified.md b/pages/ditto/protocol/things/events/featuremodified.md
deleted file mode 100644
index 091c434..0000000
--- a/pages/ditto/protocol/things/events/featuremodified.md
+++ /dev/null
@@ -1,18 +0,0 @@
-## FeatureModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/features/accelerometer",
-  "value": {
-    "properties": {
-      "x": 3.141,
-      "y": 2.718,
-      "z": 1,
-      "unit": "g"
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featurepropertiescreated.md b/pages/ditto/protocol/things/events/featurepropertiescreated.md
deleted file mode 100644
index 9bc8e6a..0000000
--- a/pages/ditto/protocol/things/events/featurepropertiescreated.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## FeaturePropertiesCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "value": {
-    "x": 3.141,
-    "y": 2.718,
-    "z": 1,
-    "unit": "g"
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featurepropertiesdeleted.md b/pages/ditto/protocol/things/events/featurepropertiesdeleted.md
deleted file mode 100644
index 62408b0..0000000
--- a/pages/ditto/protocol/things/events/featurepropertiesdeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## FeaturePropertiesDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featurepropertiesmodified.md b/pages/ditto/protocol/things/events/featurepropertiesmodified.md
deleted file mode 100644
index 87e4782..0000000
--- a/pages/ditto/protocol/things/events/featurepropertiesmodified.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## FeaturePropertiesModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/features/accelerometer/properties",
-  "value": {
-    "x": 3.141,
-    "y": 2.718,
-    "z": 1,
-    "unit": "g"
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featurepropertycreated.md b/pages/ditto/protocol/things/events/featurepropertycreated.md
deleted file mode 100644
index 3e443ea..0000000
--- a/pages/ditto/protocol/things/events/featurepropertycreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## FeaturePropertyCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "value": 42,
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featurepropertydeleted.md b/pages/ditto/protocol/things/events/featurepropertydeleted.md
deleted file mode 100644
index 1f7d326..0000000
--- a/pages/ditto/protocol/things/events/featurepropertydeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## FeaturePropertyDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featurepropertymodified.md b/pages/ditto/protocol/things/events/featurepropertymodified.md
deleted file mode 100644
index 8b6e7f2..0000000
--- a/pages/ditto/protocol/things/events/featurepropertymodified.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## FeaturePropertyModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/features/accelerometer/properties/x",
-  "value": 42,
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featurescreated.md b/pages/ditto/protocol/things/events/featurescreated.md
deleted file mode 100644
index 18ed968..0000000
--- a/pages/ditto/protocol/things/events/featurescreated.md
+++ /dev/null
@@ -1,20 +0,0 @@
-## FeaturesCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/features",
-  "value": {
-    "accelerometer": {
-      "properties": {
-        "x": 3.141,
-        "y": 2.718,
-        "z": 1,
-        "unit": "g"
-      }
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featuresdeleted.md b/pages/ditto/protocol/things/events/featuresdeleted.md
deleted file mode 100644
index d61a4e1..0000000
--- a/pages/ditto/protocol/things/events/featuresdeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## FeaturesDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/features",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/featuresmodified.md b/pages/ditto/protocol/things/events/featuresmodified.md
deleted file mode 100644
index 1deda20..0000000
--- a/pages/ditto/protocol/things/events/featuresmodified.md
+++ /dev/null
@@ -1,20 +0,0 @@
-## FeaturesModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/features",
-  "value": {
-    "accelerometer": {
-      "properties": {
-        "x": 3.141,
-        "y": 2.718,
-        "z": 1,
-        "unit": "g"
-      }
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/policyidcreated.md b/pages/ditto/protocol/things/events/policyidcreated.md
deleted file mode 100644
index cbeda4b..0000000
--- a/pages/ditto/protocol/things/events/policyidcreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## PolicyIdCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/policyId",
-  "value": "com.acme:xdk_53",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/policyidmodified.md b/pages/ditto/protocol/things/events/policyidmodified.md
deleted file mode 100644
index 716cb92..0000000
--- a/pages/ditto/protocol/things/events/policyidmodified.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## PolicyIdModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/policyId",
-  "value": "com.acme:xdk_53",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/thingcreated.md b/pages/ditto/protocol/things/events/thingcreated.md
deleted file mode 100644
index d6c7266..0000000
--- a/pages/ditto/protocol/things/events/thingcreated.md
+++ /dev/null
@@ -1,30 +0,0 @@
-## ThingCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/thingdefinitioncreated.md b/pages/ditto/protocol/things/events/thingdefinitioncreated.md
deleted file mode 100644
index 3452d07..0000000
--- a/pages/ditto/protocol/things/events/thingdefinitioncreated.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## DefinitionCreated
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/created",
-  "headers": {},
-  "path": "/definition",
-  "value": "digitaltwin:DigitaltwinExample:1.0.0",
-  "revision": 2
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/things/events/thingdefinitiondeleted.md b/pages/ditto/protocol/things/events/thingdefinitiondeleted.md
deleted file mode 100644
index 7d23c71..0000000
--- a/pages/ditto/protocol/things/events/thingdefinitiondeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## DefinitionDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/definition",
-  "revision": 3
-}
-```
\ No newline at end of file
diff --git a/pages/ditto/protocol/things/events/thingdefinitionmodified.md b/pages/ditto/protocol/things/events/thingdefinitionmodified.md
deleted file mode 100644
index 10b994e..0000000
--- a/pages/ditto/protocol/things/events/thingdefinitionmodified.md
+++ /dev/null
@@ -1,11 +0,0 @@
-## DefinitionModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/definition",
-  "value": "digitaltwin:DigitaltwinExample:1.0.0",
-  "revision": 3
-}
-```
diff --git a/pages/ditto/protocol/things/events/thingdeleted.md b/pages/ditto/protocol/things/events/thingdeleted.md
deleted file mode 100644
index ce909d3..0000000
--- a/pages/ditto/protocol/things/events/thingdeleted.md
+++ /dev/null
@@ -1,10 +0,0 @@
-## ThingDeleted
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/deleted",
-  "headers": {},
-  "path": "/",
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/events/thingmodified.md b/pages/ditto/protocol/things/events/thingmodified.md
deleted file mode 100644
index 6f938c3..0000000
--- a/pages/ditto/protocol/things/events/thingmodified.md
+++ /dev/null
@@ -1,30 +0,0 @@
-## ThingModified
-
-```json
-{
-  "topic": "com.acme/xdk_53/things/twin/events/modified",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "thingId": "com.acme:xdk_53",
-    "policyId": "com.acme:the_policy_id",
-    "attributes": {
-      "location": {
-        "latitude": 44.673856,
-        "longitude": 8.261719
-      }
-    },
-    "features": {
-      "accelerometer": {
-        "properties": {
-          "x": 3.141,
-          "y": 2.718,
-          "z": 1,
-          "unit": "g"
-        }
-      }
-    }
-  },
-  "revision": 1
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/thingerrorresponse.md b/pages/ditto/protocol/things/exceptions/thingerrorresponse.md
deleted file mode 100644
index 49dbc53..0000000
--- a/pages/ditto/protocol/things/exceptions/thingerrorresponse.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## ThingErrorResponse
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:thing.notfound",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_acl_entry_invalid.md b/pages/ditto/protocol/things/exceptions/things_acl_entry_invalid.md
deleted file mode 100644
index 1693c37..0000000
--- a/pages/ditto/protocol/things/exceptions/things_acl_entry_invalid.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## things:acl.entry.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:acl.entry.invalid",
-    "message": "The Access Control List Entry is invalid."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_acl_invalid.md b/pages/ditto/protocol/things/exceptions/things_acl_invalid.md
deleted file mode 100644
index ccbcc7a..0000000
--- a/pages/ditto/protocol/things/exceptions/things_acl_invalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:acl.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:acl.invalid",
-    "message": "The Access Control List of the Thing with ID 'com.acme:xdk_53' is invalid.",
-    "description": "There always has to be at least one ACL Entry with <READ, WRITE, ADMINISTRATE> permissions."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_acl_modificationinvalid.md b/pages/ditto/protocol/things/exceptions/things_acl_modificationinvalid.md
deleted file mode 100644
index d8fbb7f..0000000
--- a/pages/ditto/protocol/things/exceptions/things_acl_modificationinvalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:acl.modificationinvalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:acl.modificationinvalid",
-    "message": "The modified Access Control List of the Thing with ID 'com.acme:xdk_53' is invalid.",
-    "description": "There always has to be at least one ACL Entry with <READ, WRITE, ADMINISTRATE> permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_acl_not_allowed.md b/pages/ditto/protocol/things/exceptions/things_acl_not_allowed.md
deleted file mode 100644
index b6f077e..0000000
--- a/pages/ditto/protocol/things/exceptions/things_acl_not_allowed.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:acl.not.allowed
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:acl.not.allowed",
-    "message": "The schema version of the Thing with ID 'com.acme:xdk_53' does not allow Access Control List.",
-    "description": "Things in schema version 2 and higher use policies for permission management."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_acl_notfound.md b/pages/ditto/protocol/things/exceptions/things_acl_notfound.md
deleted file mode 100644
index c9f2c0c..0000000
--- a/pages/ditto/protocol/things/exceptions/things_acl_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:acl.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:acl.notfound",
-    "message": "The ACL Entry for the Authorization Subject 'the_acl_subject' on the Thing with ID 'com.acme:xdk_53' could not be found.",
-    "description": "Check if the ID of the Thing and the authorized subject of your request was correct."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_acl_notmodifiable.md b/pages/ditto/protocol/things/exceptions/things_acl_notmodifiable.md
deleted file mode 100644
index c6c3006..0000000
--- a/pages/ditto/protocol/things/exceptions/things_acl_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:acl.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:acl.notmodifiable",
-    "message": "The Access Control List of the Thing with ID 'com.acme:xdk_53' could not be modified.",
-    "description": "Check if the ID of the thing was correct and you have sufficient permissions. If you wanted to modify the complete Thing, try modifying it without also changing the Access Control List ('acl')."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_attribute_notfound.md b/pages/ditto/protocol/things/exceptions/things_attribute_notfound.md
deleted file mode 100644
index 8574c5d..0000000
--- a/pages/ditto/protocol/things/exceptions/things_attribute_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:attribute.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:attribute.notfound",
-    "message": "The attribute with key '/location' on the thing with ID 'com.acme:xdk_53' could not be found or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the thing and the key of your requested attribute was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_attribute_notmodifiable.md b/pages/ditto/protocol/things/exceptions/things_attribute_notmodifiable.md
deleted file mode 100644
index b6a2f2d..0000000
--- a/pages/ditto/protocol/things/exceptions/things_attribute_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:attribute.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:attribute.notmodifiable",
-    "message": " The Attribute with name '/location' on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required).",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_attributes_notfound.md b/pages/ditto/protocol/things/exceptions/things_attributes_notfound.md
deleted file mode 100644
index 40cf910..0000000
--- a/pages/ditto/protocol/things/exceptions/things_attributes_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:attributes.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:attributes.notfound",
-    "message": "The Attributes of the Thing with ID 'com.acme:xdk_53' could not be found or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_attributes_notmodifiable.md b/pages/ditto/protocol/things/exceptions/things_attributes_notmodifiable.md
deleted file mode 100644
index ebc8a86..0000000
--- a/pages/ditto/protocol/things/exceptions/things_attributes_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:attributes.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:attributes.notmodifiable",
-    "message": "The Attributes on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required).",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_feature_definition_empty.md b/pages/ditto/protocol/things/exceptions/things_feature_definition_empty.md
deleted file mode 100644
index 060f68c..0000000
--- a/pages/ditto/protocol/things/exceptions/things_feature_definition_empty.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.definition.empty
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:feature.definition.empty",
-    "message": "Feature Definition must not be empty!",
-    "description": "A Feature Definition must contain at least one element. It can however also be set to null or deleted completely."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_feature_definition_identifier_invalid.md b/pages/ditto/protocol/things/exceptions/things_feature_definition_identifier_invalid.md
deleted file mode 100644
index 62dd437..0000000
--- a/pages/ditto/protocol/things/exceptions/things_feature_definition_identifier_invalid.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.definition.identifier.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:feature.definition.identifier.invalid",
-    "message": "Feature Definition Identifier <foo:bar> is invalid!",
-    "description": "An Identifier string is expected to have the structure 'namespace:name:version'. Each segment must contain at least one char of [_a-zA-Z0-9\\-.]"
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_feature_definition_notfound.md b/pages/ditto/protocol/things/exceptions/things_feature_definition_notfound.md
deleted file mode 100644
index 036a8eb..0000000
--- a/pages/ditto/protocol/things/exceptions/things_feature_definition_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.definition.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:feature.definition.notfound",
-    "message": "The Definition of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' does not exist or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_feature_definition_notmodifiable.md b/pages/ditto/protocol/things/exceptions/things_feature_definition_notmodifiable.md
deleted file mode 100644
index 457179e..0000000
--- a/pages/ditto/protocol/things/exceptions/things_feature_definition_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.definition.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:feature.definition.notmodifiable",
-    "message": "The Definition of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required).",
-    "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_feature_notfound.md b/pages/ditto/protocol/things/exceptions/things_feature_notfound.md
deleted file mode 100644
index bef390d..0000000
--- a/pages/ditto/protocol/things/exceptions/things_feature_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:feature.notfound",
-    "message": "The Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' could not be found or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing and the ID of your requested Feature was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_feature_notmodifiable.md b/pages/ditto/protocol/things/exceptions/things_feature_notmodifiable.md
deleted file mode 100644
index dadc051..0000000
--- a/pages/ditto/protocol/things/exceptions/things_feature_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:feature.notmodifiable",
-    "message": "The Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions to modify it (WRITE is required).",
-    "description": "Check if the ID of the Thing and the ID of your requested Feature was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_feature_properties_notfound.md b/pages/ditto/protocol/things/exceptions/things_feature_properties_notfound.md
deleted file mode 100644
index f970ac6..0000000
--- a/pages/ditto/protocol/things/exceptions/things_feature_properties_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.properties.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:feature.properties.notfound",
-    "message": "The Properties of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' do not exist or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_feature_properties_notmodifiable.md b/pages/ditto/protocol/things/exceptions/things_feature_properties_notmodifiable.md
deleted file mode 100644
index 56878ed..0000000
--- a/pages/ditto/protocol/things/exceptions/things_feature_properties_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.properties.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:feature.properties.notmodifiable",
-    "message": "The Properties of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required).",
-    "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_feature_property_notfound.md b/pages/ditto/protocol/things/exceptions/things_feature_property_notfound.md
deleted file mode 100644
index bc9ed32..0000000
--- a/pages/ditto/protocol/things/exceptions/things_feature_property_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.property.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:feature.property.notfound",
-    "message": "The Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' does not exist or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing, the Feature ID and the key of your requested property was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_feature_property_notmodifiable.md b/pages/ditto/protocol/things/exceptions/things_feature_property_notmodifiable.md
deleted file mode 100644
index ed61cf3..0000000
--- a/pages/ditto/protocol/things/exceptions/things_feature_property_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:feature.property.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:feature.property.notmodifiable",
-    "message": "The Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions to modify it (WRITE is required).",
-    "description": "Check if the ID of the Thing, the Feature ID and the key of your requested property was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_features_notfound.md b/pages/ditto/protocol/things/exceptions/things_features_notfound.md
deleted file mode 100644
index 803f86d..0000000
--- a/pages/ditto/protocol/things/exceptions/things_features_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:features.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:features.notfound",
-    "message": "The Features on the Thing with ID 'com.acme:xdk_53' do not exist or the requester had insufficient permissions to access it.",
-    "description": "Check if the ID of the Thing was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_features_notmodifiable.md b/pages/ditto/protocol/things/exceptions/things_features_notmodifiable.md
deleted file mode 100644
index 14774e4..0000000
--- a/pages/ditto/protocol/things/exceptions/things_features_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:features.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:features.notmodifiable",
-    "message": "The Features on the Thing with ID 'com.acme:xdk_53' cannot be modified as requester had insufficient permissions to modify it (WRITE is required).",
-    "description": "Check if the ID of the Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_id_invalid.md b/pages/ditto/protocol/things/exceptions/things_id_invalid.md
deleted file mode 100644
index ac0cf4e..0000000
--- a/pages/ditto/protocol/things/exceptions/things_id_invalid.md
+++ /dev/null
@@ -1,17 +0,0 @@
-## things:id.invalid
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:id.invalid",
-    "message": "Thing ID 'invalid id' is not valid!",
-    "description": "It must conform to the namespaced entity ID notation (see Ditto documentation)",
-    "url": "https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id"
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_id_notsettable.md b/pages/ditto/protocol/things/exceptions/things_id_notsettable.md
deleted file mode 100644
index 249138d..0000000
--- a/pages/ditto/protocol/things/exceptions/things_id_notsettable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:id.notsettable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:id.notsettable",
-    "message": "The Thing ID in the request body is not equal to the Thing ID in the request URL.",
-    "description": "Either delete the Thing ID from the request body or use the same Thing ID as in the request URL."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_policyId_notallowed.md b/pages/ditto/protocol/things/exceptions/things_policyId_notallowed.md
deleted file mode 100644
index 19f9912..0000000
--- a/pages/ditto/protocol/things/exceptions/things_policyId_notallowed.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:policyId.notallowed
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:policyId.notallowed",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be modified as it contained an inline Policy with an ID or a Policy ID and a Policy",
-    "description": "If you want to use an existing Policy, specify it as 'policyId' in the Thing JSON. If you want to create a Thing with inline Policy, no Policy ID is allowed as it will be created with the Thing ID."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_policyId_notmodifiable.md b/pages/ditto/protocol/things/exceptions/things_policyId_notmodifiable.md
deleted file mode 100644
index db3aa6a..0000000
--- a/pages/ditto/protocol/things/exceptions/things_policyId_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:policyId.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:policyId.notmodifiable",
-    "message": "The Policy ID of the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required).",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_policy_notallowed.md b/pages/ditto/protocol/things/exceptions/things_policy_notallowed.md
deleted file mode 100644
index 6cde066..0000000
--- a/pages/ditto/protocol/things/exceptions/things_policy_notallowed.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:policy.notallowed
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:policy.notallowed",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be modified as it contained an inline Policy",
-    "description": "Once a Thing with inline Policy is created it can't be modified with another Policy. Use the Policy resources to modify the existing Policy."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_thing_conflict.md b/pages/ditto/protocol/things/exceptions/things_thing_conflict.md
deleted file mode 100644
index c02db3a..0000000
--- a/pages/ditto/protocol/things/exceptions/things_thing_conflict.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.conflict
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 409,
-    "error": "things:thing.conflict",
-    "message": "The Thing with ID 'com.acme:xdk_53' already exists",
-    "description": "Choose another Thing ID"
-  },
-  "status": 409
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_thing_notcreatable.md b/pages/ditto/protocol/things/exceptions/things_thing_notcreatable.md
deleted file mode 100644
index 1d54531..0000000
--- a/pages/ditto/protocol/things/exceptions/things_thing_notcreatable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.notcreatable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 400,
-    "error": "things:thing.notcreatable",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be created as the Policy with ID 'com.acme:the_policy_id' is not existing.",
-    "description": "Check if the ID of the Policy you created the Thing with is correct and that the Policy is existing."
-  },
-  "status": 400
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_thing_notdeletable.md b/pages/ditto/protocol/things/exceptions/things_thing_notdeletable.md
deleted file mode 100644
index df116c7..0000000
--- a/pages/ditto/protocol/things/exceptions/things_thing_notdeletable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.notdeletable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:thing.notdeletable",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be deleted as the requester had insufficient permissions ( WRITE on root resource is required).",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_thing_notfound.md b/pages/ditto/protocol/things/exceptions/things_thing_notfound.md
deleted file mode 100644
index 7c76380..0000000
--- a/pages/ditto/protocol/things/exceptions/things_thing_notfound.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.notfound
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 404,
-    "error": "things:thing.notfound",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be found or requester had insufficient permissions to access it.",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 404
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_thing_notmodifiable.md b/pages/ditto/protocol/things/exceptions/things_thing_notmodifiable.md
deleted file mode 100644
index 1f6d44c..0000000
--- a/pages/ditto/protocol/things/exceptions/things_thing_notmodifiable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.notmodifiable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 403,
-    "error": "things:thing.notmodifiable",
-    "message": "The Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required).",
-    "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
-  },
-  "status": 403
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_thing_toomanymodifyingrequests.md b/pages/ditto/protocol/things/exceptions/things_thing_toomanymodifyingrequests.md
deleted file mode 100644
index 901e379..0000000
--- a/pages/ditto/protocol/things/exceptions/things_thing_toomanymodifyingrequests.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.toomanymodifyingrequests
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 429,
-    "error": "things:thing.toomanymodifyingrequests",
-    "message": "Too many modifying requests are already outstanding to the Thing with ID 'com.acme:xdk_53'.",
-    "description": "Throttle your modifying requests to the Thing or re-structure your Thing in multiple Things if you really need so many concurrent modifications."
-  },
-  "status": 429
-}
-```
diff --git a/pages/ditto/protocol/things/exceptions/things_thing_unavailable.md b/pages/ditto/protocol/things/exceptions/things_thing_unavailable.md
deleted file mode 100644
index 0d7f852..0000000
--- a/pages/ditto/protocol/things/exceptions/things_thing_unavailable.md
+++ /dev/null
@@ -1,16 +0,0 @@
-## things:thing.unavailable
-
-```json
-{
-  "topic": "unknown/unknown/things/twin/errors",
-  "headers": {},
-  "path": "/",
-  "value": {
-    "status": 503,
-    "error": "things:thing.unavailable",
-    "message": "The Thing with ID 'com.acme:xdk_53' is not available, please try again later.",
-    "description": "The requested Thing is temporarily not available."
-  },
-  "status": 503
-}
-```
diff --git a/presentations.html b/presentations.html
index a33f5c7..578ae40 100644
--- a/presentations.html
+++ b/presentations.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-bindings.html b/protocol-bindings.html
index 9501403..eff9f35 100644
--- a/protocol-bindings.html
+++ b/protocol-bindings.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-createattribute.html b/protocol-examples-createattribute.html
index 32b4b72..46b0f22 100644
--- a/protocol-examples-createattribute.html
+++ b/protocol-examples-createattribute.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-createattributes.html b/protocol-examples-createattributes.html
index 73915ba..162ceea 100644
--- a/protocol-examples-createattributes.html
+++ b/protocol-examples-createattributes.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-createdefinition.html b/protocol-examples-createdefinition.html
index 4e0088b..134543b 100644
--- a/protocol-examples-createdefinition.html
+++ b/protocol-examples-createdefinition.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-createfeature.html b/protocol-examples-createfeature.html
index 690e282..db2d0dc 100644
--- a/protocol-examples-createfeature.html
+++ b/protocol-examples-createfeature.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-createfeatures.html b/protocol-examples-createfeatures.html
index ec45c0e..28883ad 100644
--- a/protocol-examples-createfeatures.html
+++ b/protocol-examples-createfeatures.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-createproperties.html b/protocol-examples-createproperties.html
index 22320d2..c6aa893 100644
--- a/protocol-examples-createproperties.html
+++ b/protocol-examples-createproperties.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-createproperty.html b/protocol-examples-createproperty.html
index bfe1de1..33b060c 100644
--- a/protocol-examples-createproperty.html
+++ b/protocol-examples-createproperty.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-creatething.html b/protocol-examples-creatething.html
index ec286b4..d299aa5 100644
--- a/protocol-examples-creatething.html
+++ b/protocol-examples-creatething.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-createthingdefinition.html b/protocol-examples-createthingdefinition.html
index 50338bf..0975a7a 100644
--- a/protocol-examples-createthingdefinition.html
+++ b/protocol-examples-createthingdefinition.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-deleteattribute.html b/protocol-examples-deleteattribute.html
index 6645fc3..56a9bcc 100644
--- a/protocol-examples-deleteattribute.html
+++ b/protocol-examples-deleteattribute.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-deleteattributes.html b/protocol-examples-deleteattributes.html
index 3e66001..85e2dd5 100644
--- a/protocol-examples-deleteattributes.html
+++ b/protocol-examples-deleteattributes.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-deletedefinition.html b/protocol-examples-deletedefinition.html
index 68b4965..cd16a3d 100644
--- a/protocol-examples-deletedefinition.html
+++ b/protocol-examples-deletedefinition.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-deletefeature.html b/protocol-examples-deletefeature.html
index 2be496f..b71b306 100644
--- a/protocol-examples-deletefeature.html
+++ b/protocol-examples-deletefeature.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-deletefeatures.html b/protocol-examples-deletefeatures.html
index 4576f8e..2543a3e 100644
--- a/protocol-examples-deletefeatures.html
+++ b/protocol-examples-deletefeatures.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-deleteproperties.html b/protocol-examples-deleteproperties.html
index 0afe256..aa35bbf 100644
--- a/protocol-examples-deleteproperties.html
+++ b/protocol-examples-deleteproperties.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-deleteproperty.html b/protocol-examples-deleteproperty.html
index 3c54b7b..a8ff3e5 100644
--- a/protocol-examples-deleteproperty.html
+++ b/protocol-examples-deleteproperty.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-deletething.html b/protocol-examples-deletething.html
index 2e73bc2..2e57d73 100644
--- a/protocol-examples-deletething.html
+++ b/protocol-examples-deletething.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-deletethingdefinition.html b/protocol-examples-deletethingdefinition.html
index 8233ff7..0b40453 100644
--- a/protocol-examples-deletethingdefinition.html
+++ b/protocol-examples-deletethingdefinition.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-errorresponses.html b/protocol-examples-errorresponses.html
index a157592..de93466 100644
--- a/protocol-examples-errorresponses.html
+++ b/protocol-examples-errorresponses.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-modifyattribute.html b/protocol-examples-modifyattribute.html
index d2f489c..353e7bb 100644
--- a/protocol-examples-modifyattribute.html
+++ b/protocol-examples-modifyattribute.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-modifyattributes.html b/protocol-examples-modifyattributes.html
index 963d431..bc9dbca 100644
--- a/protocol-examples-modifyattributes.html
+++ b/protocol-examples-modifyattributes.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-modifydefinition.html b/protocol-examples-modifydefinition.html
index cddab6c..756fab2 100644
--- a/protocol-examples-modifydefinition.html
+++ b/protocol-examples-modifydefinition.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-modifyfeature.html b/protocol-examples-modifyfeature.html
index 92f510d..fec126f 100644
--- a/protocol-examples-modifyfeature.html
+++ b/protocol-examples-modifyfeature.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-modifyfeatures.html b/protocol-examples-modifyfeatures.html
index e610e12..5767a63 100644
--- a/protocol-examples-modifyfeatures.html
+++ b/protocol-examples-modifyfeatures.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-modifypolicyid.html b/protocol-examples-modifypolicyid.html
index b1613b7..a16d29f 100644
--- a/protocol-examples-modifypolicyid.html
+++ b/protocol-examples-modifypolicyid.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-modifyproperties.html b/protocol-examples-modifyproperties.html
index 75fabeb..a3e12bc 100644
--- a/protocol-examples-modifyproperties.html
+++ b/protocol-examples-modifyproperties.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-modifyproperty.html b/protocol-examples-modifyproperty.html
index 93a91d3..4cad6c2 100644
--- a/protocol-examples-modifyproperty.html
+++ b/protocol-examples-modifyproperty.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-modifything.html b/protocol-examples-modifything.html
index 1f8bb60..303163a 100644
--- a/protocol-examples-modifything.html
+++ b/protocol-examples-modifything.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-modifythingdefinition.html b/protocol-examples-modifythingdefinition.html
index 49370d6..e87987e 100644
--- a/protocol-examples-modifythingdefinition.html
+++ b/protocol-examples-modifythingdefinition.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-createpolicy.html b/protocol-examples-policies-createpolicy.html
index 170e3db..48fbd90 100644
--- a/protocol-examples-policies-createpolicy.html
+++ b/protocol-examples-policies-createpolicy.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-createpolicyentry.html b/protocol-examples-policies-createpolicyentry.html
index 7ebe2c3..4ac1781 100644
--- a/protocol-examples-policies-createpolicyentry.html
+++ b/protocol-examples-policies-createpolicyentry.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-createresource.html b/protocol-examples-policies-createresource.html
index 3584b5b..9c92b8d 100644
--- a/protocol-examples-policies-createresource.html
+++ b/protocol-examples-policies-createresource.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-createsubject.html b/protocol-examples-policies-createsubject.html
index b44ca76..a555ca0 100644
--- a/protocol-examples-policies-createsubject.html
+++ b/protocol-examples-policies-createsubject.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-deletepolicy.html b/protocol-examples-policies-deletepolicy.html
index eb5492c..0ccd7ec 100644
--- a/protocol-examples-policies-deletepolicy.html
+++ b/protocol-examples-policies-deletepolicy.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-deletepolicyentry.html b/protocol-examples-policies-deletepolicyentry.html
index 229b3d4..d16ae61 100644
--- a/protocol-examples-policies-deletepolicyentry.html
+++ b/protocol-examples-policies-deletepolicyentry.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-deleteresource.html b/protocol-examples-policies-deleteresource.html
index adb5ef9..f39c317 100644
--- a/protocol-examples-policies-deleteresource.html
+++ b/protocol-examples-policies-deleteresource.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-deletesubject.html b/protocol-examples-policies-deletesubject.html
index 72f48f8..af79aaa 100644
--- a/protocol-examples-policies-deletesubject.html
+++ b/protocol-examples-policies-deletesubject.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-errorresponses.html b/protocol-examples-policies-errorresponses.html
index 6b74eee..852cc97 100644
--- a/protocol-examples-policies-errorresponses.html
+++ b/protocol-examples-policies-errorresponses.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-modifypolicy.html b/protocol-examples-policies-modifypolicy.html
index 6a7ab1a..1c5be10 100644
--- a/protocol-examples-policies-modifypolicy.html
+++ b/protocol-examples-policies-modifypolicy.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-modifypolicyentries.html b/protocol-examples-policies-modifypolicyentries.html
index 8ec97ec..48d2b37 100644
--- a/protocol-examples-policies-modifypolicyentries.html
+++ b/protocol-examples-policies-modifypolicyentries.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-modifypolicyentry.html b/protocol-examples-policies-modifypolicyentry.html
index d0a21ae..09bb1ea 100644
--- a/protocol-examples-policies-modifypolicyentry.html
+++ b/protocol-examples-policies-modifypolicyentry.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-modifyresource.html b/protocol-examples-policies-modifyresource.html
index 4a183b3..2b06821 100644
--- a/protocol-examples-policies-modifyresource.html
+++ b/protocol-examples-policies-modifyresource.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-modifyresources.html b/protocol-examples-policies-modifyresources.html
index 66feaf2..05bbdde 100644
--- a/protocol-examples-policies-modifyresources.html
+++ b/protocol-examples-policies-modifyresources.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-modifysubject.html b/protocol-examples-policies-modifysubject.html
index f7b694a..813e46a 100644
--- a/protocol-examples-policies-modifysubject.html
+++ b/protocol-examples-policies-modifysubject.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-modifysubjects.html b/protocol-examples-policies-modifysubjects.html
index 4f36d8c..b69d7f3 100644
--- a/protocol-examples-policies-modifysubjects.html
+++ b/protocol-examples-policies-modifysubjects.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-retrievepolicy.html b/protocol-examples-policies-retrievepolicy.html
index 4b8be76..a80f1a2 100644
--- a/protocol-examples-policies-retrievepolicy.html
+++ b/protocol-examples-policies-retrievepolicy.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-retrievepolicyentries.html b/protocol-examples-policies-retrievepolicyentries.html
index 33e29a9..d4cd5d6 100644
--- a/protocol-examples-policies-retrievepolicyentries.html
+++ b/protocol-examples-policies-retrievepolicyentries.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-retrievepolicyentry.html b/protocol-examples-policies-retrievepolicyentry.html
index fb34df0..52eda3c 100644
--- a/protocol-examples-policies-retrievepolicyentry.html
+++ b/protocol-examples-policies-retrievepolicyentry.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-retrieveresource.html b/protocol-examples-policies-retrieveresource.html
index f1d6956..be29027 100644
--- a/protocol-examples-policies-retrieveresource.html
+++ b/protocol-examples-policies-retrieveresource.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-retrieveresources.html b/protocol-examples-policies-retrieveresources.html
index 209dfe8..a6a2c19 100644
--- a/protocol-examples-policies-retrieveresources.html
+++ b/protocol-examples-policies-retrieveresources.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-retrievesubject.html b/protocol-examples-policies-retrievesubject.html
index 2c6dba3..1496d93 100644
--- a/protocol-examples-policies-retrievesubject.html
+++ b/protocol-examples-policies-retrievesubject.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-policies-retrievesubjects.html b/protocol-examples-policies-retrievesubjects.html
index afe75e1..4a1c262 100644
--- a/protocol-examples-policies-retrievesubjects.html
+++ b/protocol-examples-policies-retrievesubjects.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-retrieveattribute.html b/protocol-examples-retrieveattribute.html
index a731218..a85e04b 100644
--- a/protocol-examples-retrieveattribute.html
+++ b/protocol-examples-retrieveattribute.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-retrieveattributes.html b/protocol-examples-retrieveattributes.html
index d38c2d1..d45ee86 100644
--- a/protocol-examples-retrieveattributes.html
+++ b/protocol-examples-retrieveattributes.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-retrievedefinition.html b/protocol-examples-retrievedefinition.html
index b9cc629..fafebae 100644
--- a/protocol-examples-retrievedefinition.html
+++ b/protocol-examples-retrievedefinition.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-retrievefeature.html b/protocol-examples-retrievefeature.html
index e6b5649..2bd82b4 100644
--- a/protocol-examples-retrievefeature.html
+++ b/protocol-examples-retrievefeature.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-retrievefeatures.html b/protocol-examples-retrievefeatures.html
index 2bc6b7e..c60b207 100644
--- a/protocol-examples-retrievefeatures.html
+++ b/protocol-examples-retrievefeatures.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-retrieveproperties.html b/protocol-examples-retrieveproperties.html
index 1d0ccd4..78300f0 100644
--- a/protocol-examples-retrieveproperties.html
+++ b/protocol-examples-retrieveproperties.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-retrieveproperty.html b/protocol-examples-retrieveproperty.html
index 66caadf..d26db84 100644
--- a/protocol-examples-retrieveproperty.html
+++ b/protocol-examples-retrieveproperty.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-retrievething.html b/protocol-examples-retrievething.html
index c092d6a..eaf706e 100644
--- a/protocol-examples-retrievething.html
+++ b/protocol-examples-retrievething.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-retrievethingdefinition.html b/protocol-examples-retrievethingdefinition.html
index 85e0ed5..6078fc0 100644
--- a/protocol-examples-retrievethingdefinition.html
+++ b/protocol-examples-retrievethingdefinition.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-retrievethings.html b/protocol-examples-retrievethings.html
index db29aaa..e50af2e 100644
--- a/protocol-examples-retrievethings.html
+++ b/protocol-examples-retrievethings.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples-search.html b/protocol-examples-search.html
index 60668f4..0914aae 100644
--- a/protocol-examples-search.html
+++ b/protocol-examples-search.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-examples.html b/protocol-examples.html
index de59ee1..adc4101 100644
--- a/protocol-examples.html
+++ b/protocol-examples.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-overview.html b/protocol-overview.html
index 411bde6..51156cc 100644
--- a/protocol-overview.html
+++ b/protocol-overview.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-acks.html b/protocol-specification-acks.html
index f799629..cc27ea9 100644
--- a/protocol-specification-acks.html
+++ b/protocol-specification-acks.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-policies-create-or-modify.html b/protocol-specification-policies-create-or-modify.html
index 391c0b1..f52ef3a 100644
--- a/protocol-specification-policies-create-or-modify.html
+++ b/protocol-specification-policies-create-or-modify.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-policies-delete.html b/protocol-specification-policies-delete.html
index 4fbf64a..9739a64 100644
--- a/protocol-specification-policies-delete.html
+++ b/protocol-specification-policies-delete.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-policies-retrieve.html b/protocol-specification-policies-retrieve.html
index 87277d3..45d7f31 100644
--- a/protocol-specification-policies-retrieve.html
+++ b/protocol-specification-policies-retrieve.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-policies.html b/protocol-specification-policies.html
index d0fc217..bf9ac69 100644
--- a/protocol-specification-policies.html
+++ b/protocol-specification-policies.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-things-create-or-modify.html b/protocol-specification-things-create-or-modify.html
index 32ede3d..a9e8725 100644
--- a/protocol-specification-things-create-or-modify.html
+++ b/protocol-specification-things-create-or-modify.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-things-delete.html b/protocol-specification-things-delete.html
index a3cc740..1c6d8ac 100644
--- a/protocol-specification-things-delete.html
+++ b/protocol-specification-things-delete.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-things-messages.html b/protocol-specification-things-messages.html
index e39b49c..3b8a9b2 100644
--- a/protocol-specification-things-messages.html
+++ b/protocol-specification-things-messages.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-things-retrieve.html b/protocol-specification-things-retrieve.html
index bd1936a..1e62771 100644
--- a/protocol-specification-things-retrieve.html
+++ b/protocol-specification-things-retrieve.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-things-search.html b/protocol-specification-things-search.html
index 050472c..80ee3c9 100644
--- a/protocol-specification-things-search.html
+++ b/protocol-specification-things-search.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-things.html b/protocol-specification-things.html
index d744545..3488a47 100644
--- a/protocol-specification-things.html
+++ b/protocol-specification-things.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification-topic.html b/protocol-specification-topic.html
index d1db8cd..8120de8 100644
--- a/protocol-specification-topic.html
+++ b/protocol-specification-topic.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-specification.html b/protocol-specification.html
index 230c7ef..24f5024 100644
--- a/protocol-specification.html
+++ b/protocol-specification.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/protocol-twinlive.html b/protocol-twinlive.html
index 3a08642..2b05345 100644
--- a/protocol-twinlive.html
+++ b/protocol-twinlive.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_010-M1.html b/release_notes_010-M1.html
index 8ea8d20..fe78f1e 100644
--- a/release_notes_010-M1.html
+++ b/release_notes_010-M1.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_010-M3.html b/release_notes_010-M3.html
index 2a56ead..ec3b70e 100644
--- a/release_notes_010-M3.html
+++ b/release_notes_010-M3.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_020-M1.html b/release_notes_020-M1.html
index 4a8348a..fc05d04 100644
--- a/release_notes_020-M1.html
+++ b/release_notes_020-M1.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_030-M1.html b/release_notes_030-M1.html
index 1723e2c..c467f17 100644
--- a/release_notes_030-M1.html
+++ b/release_notes_030-M1.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_030-M2.html b/release_notes_030-M2.html
index 8c14944..f6acb5f 100644
--- a/release_notes_030-M2.html
+++ b/release_notes_030-M2.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_080-M1.html b/release_notes_080-M1.html
index 1b2f4e6..e967f94 100644
--- a/release_notes_080-M1.html
+++ b/release_notes_080-M1.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_080-M2.html b/release_notes_080-M2.html
index 86f3b3e..d13723a 100644
--- a/release_notes_080-M2.html
+++ b/release_notes_080-M2.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_080-M3.html b/release_notes_080-M3.html
index 9e9897f..9455d35 100644
--- a/release_notes_080-M3.html
+++ b/release_notes_080-M3.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_080.html b/release_notes_080.html
index fb2c9fe..948a665 100644
--- a/release_notes_080.html
+++ b/release_notes_080.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_090-M1.html b/release_notes_090-M1.html
index 9eac6ed..d933161 100644
--- a/release_notes_090-M1.html
+++ b/release_notes_090-M1.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_090-M2.html b/release_notes_090-M2.html
index b26eefe..958c8ac 100644
--- a/release_notes_090-M2.html
+++ b/release_notes_090-M2.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_090.html b/release_notes_090.html
index b9df6e5..95153b5 100644
--- a/release_notes_090.html
+++ b/release_notes_090.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_100-M1a.html b/release_notes_100-M1a.html
index 500eb84..abcba2b 100644
--- a/release_notes_100-M1a.html
+++ b/release_notes_100-M1a.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_100-M2.html b/release_notes_100-M2.html
index 35f5061..341e562 100644
--- a/release_notes_100-M2.html
+++ b/release_notes_100-M2.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_100.html b/release_notes_100.html
index d33c05e..727681c 100644
--- a/release_notes_100.html
+++ b/release_notes_100.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/release_notes_110.html b/release_notes_110.html
index 34bc801..3cc5254 100644
--- a/release_notes_110.html
+++ b/release_notes_110.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/sandbox.html b/sandbox.html
index d5a2a34..6ea8064 100644
--- a/sandbox.html
+++ b/sandbox.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_architecture.html b/tag_architecture.html
index cfb8fa8..e36fffa 100644
--- a/tag_architecture.html
+++ b/tag_architecture.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_blog.html b/tag_blog.html
index f1a7670..69b04db 100644
--- a/tag_blog.html
+++ b/tag_blog.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_client_sdk.html b/tag_client_sdk.html
index 5875038..3cb929e 100644
--- a/tag_client_sdk.html
+++ b/tag_client_sdk.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_connectivity.html b/tag_connectivity.html
index 8b6db23..bb87d84 100644
--- a/tag_connectivity.html
+++ b/tag_connectivity.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_getting_started.html b/tag_getting_started.html
index 5ddbe81..00b80cc 100644
--- a/tag_getting_started.html
+++ b/tag_getting_started.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_http.html b/tag_http.html
index 933071a..cb96dad 100644
--- a/tag_http.html
+++ b/tag_http.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_installation.html b/tag_installation.html
index 778169d..ffa7b1d 100644
--- a/tag_installation.html
+++ b/tag_installation.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_model.html b/tag_model.html
index 2911078..35fb0c7 100644
--- a/tag_model.html
+++ b/tag_model.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_news.html b/tag_news.html
index 40b2b67..b1ac56f 100644
--- a/tag_news.html
+++ b/tag_news.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_protocol.html b/tag_protocol.html
index ab91b29..cc085c4 100644
--- a/tag_protocol.html
+++ b/tag_protocol.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_release_notes.html b/tag_release_notes.html
index 7d6f77a..8afeb68 100644
--- a/tag_release_notes.html
+++ b/tag_release_notes.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_rql.html b/tag_rql.html
index 864b737..29b9acd 100644
--- a/tag_rql.html
+++ b/tag_rql.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_search.html b/tag_search.html
index 1287208..3526703 100644
--- a/tag_search.html
+++ b/tag_search.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_signal.html b/tag_signal.html
index 7726eb1..fdeacd4 100644
--- a/tag_signal.html
+++ b/tag_signal.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>
diff --git a/tag_troubleshooting.html b/tag_troubleshooting.html
index d8aae2b..1e93e3c 100644
--- a/tag_troubleshooting.html
+++ b/tag_troubleshooting.html
@@ -715,6 +715,11 @@
               
               
               
+              <li><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></li>
+              
+              
+              
+              
               
               
               <li><a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5 protocol binding</a></li>