diff --git a/knowledge base/diagrams as code.md b/knowledge base/diagrams as code.md
new file mode 100644
index 0000000..6a37bc1
--- /dev/null
+++ b/knowledge base/diagrams as code.md	
@@ -0,0 +1,26 @@
+# Diagrams as code
+
+1. [JavaScript](#javascript)
+   1. [Mermaid](#mermaid)
+2. [Python](#python)
+3. [Further readings](#further-readings)
+
+## JavaScript
+
+### Mermaid
+
+Use the [mermaid live editor] to have a simple diagram with no need for all the tools.
+
+## Python
+
+Use the `diagrams` library.
+
+## Further readings
+
+- [Mermaid]
+- [Python's diagrams library]
+
+<!-- external references -->
+[mermaid]: https://mermaid.js.org
+[mermaid live editor]: https://mermaid.live/edit
+[python's diagrams library]: https://diagrams.mingrammer.com/
diff --git a/knowledge base/diagrams.md b/knowledge base/diagrams.md
deleted file mode 100644
index 038656c..0000000
--- a/knowledge base/diagrams.md	
+++ /dev/null
@@ -1,7 +0,0 @@
-# Diagrams
-
-Draws your cloud system architecture using Python code.
-
-## Further readings
-
-[website]: https://diagrams.mingrammer.com/