Refactored KB about diagrams as code

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/

knowledge base/diagrams.md

@@ -1,7 +0,0 @@
-# Diagrams
-
-Draws your cloud system architecture using Python code.
-
-## Further readings
-
-[website]: https://diagrams.mingrammer.com/