diff --git a/docs/guide/guide.gradle b/docs/guide/guide.gradle
index e8b9be759..dc6203f9f 100644
--- a/docs/guide/guide.gradle
+++ b/docs/guide/guide.gradle
@@ -25,7 +25,6 @@ asciidoctor {
attributes = [
numbered : false,
'source-highlighter' : 'coderay',
- 'imagesdir' : 'images/',
'coderay-linenums-mode' : 'table',
'testdir' : '../../../../../plugins/riot/src/test/resources'
]
diff --git a/docs/guide/images/architecture.png b/docs/guide/images/architecture.png
deleted file mode 100644
index 9bc23da92..000000000
Binary files a/docs/guide/images/architecture.png and /dev/null differ
diff --git a/docs/guide/images/mapping.png b/docs/guide/images/mapping.png
deleted file mode 100644
index e6fcd3108..000000000
Binary files a/docs/guide/images/mapping.png and /dev/null differ
diff --git a/docs/guide/images/replication-architecture.png b/docs/guide/images/replication-architecture.png
deleted file mode 100644
index 954c988ca..000000000
Binary files a/docs/guide/images/replication-architecture.png and /dev/null differ
diff --git a/docs/guide/src/docs/resources/images/Diagrams.drawio b/docs/guide/src/docs/resources/images/Diagrams.drawio
new file mode 100644
index 000000000..4155cd17a
--- /dev/null
+++ b/docs/guide/src/docs/resources/images/Diagrams.drawio
@@ -0,0 +1,328 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/guide/src/docs/resources/images/architecture.svg b/docs/guide/src/docs/resources/images/architecture.svg
new file mode 100644
index 000000000..6852f6427
--- /dev/null
+++ b/docs/guide/src/docs/resources/images/architecture.svg
@@ -0,0 +1,3 @@
+
+
+
\ No newline at end of file
diff --git a/docs/guide/src/docs/resources/images/mapping.svg b/docs/guide/src/docs/resources/images/mapping.svg
new file mode 100644
index 000000000..a49d7e028
--- /dev/null
+++ b/docs/guide/src/docs/resources/images/mapping.svg
@@ -0,0 +1,3 @@
+
+
+
\ No newline at end of file
diff --git a/docs/guide/src/docs/resources/images/replication-architecture.svg b/docs/guide/src/docs/resources/images/replication-architecture.svg
new file mode 100644
index 000000000..d8f1830c5
--- /dev/null
+++ b/docs/guide/src/docs/resources/images/replication-architecture.svg
@@ -0,0 +1,3 @@
+
+
+
\ No newline at end of file
diff --git a/docs/guide/src/docs/resources/images/riot.svg b/docs/guide/src/docs/resources/images/riot.svg
new file mode 100644
index 000000000..b8f75f6f2
--- /dev/null
+++ b/docs/guide/src/docs/resources/images/riot.svg
@@ -0,0 +1,147 @@
+
+