Add conceptual diagram of GitOps-based infrastructure

.markdownlint.json

@@ -5,5 +5,13 @@
   "no-bare-urls": false,
 
   "comment": "Ignore errors like MD026/no-trailing-punctuation Trailing punctuation in heading [Punctuation: '?'] in README.md's title",
-  "no-trailing-punctuation": false
+  "no-trailing-punctuation": false,
+
+  "comment": "Ignore some MD033/no-inline-html errors, as we sometimes need raw HTML for more advanced styling",
+  "no-inline-html": {
+    "allowed_elements": [
+      "p",
+      "img"
+    ]
+  }
 }

README.md

@@ -9,12 +9,14 @@ A curated list for awesome GitOps resources inspired by [@sindresorhus' awesome]
 GitOps is a way to do [Continuous Delivery](https://en.wikipedia.org/wiki/Continuous_delivery).
 It works by using [Git](https://git-scm.com/) as a single source of truth for
 [declarative infrastructure and applications](https://en.wikipedia.org/wiki/Infrastructure_as_code),
-together with tools ensuring the actual state of infrastructure and
-applications converges towards the target state declared in Git. With Git at
+together with tools ensuring the _actual state_ of infrastructure and
+applications converges towards the _desired state_ declared in Git. With Git at
 the center of your delivery pipelines, developers can make pull requests to
 accelerate and simplify application deployments and operations tasks to your
 infrastructure or container-orchestration system (e.g. [Kubernetes](https://kubernetes.io/)).
 
+<p align="center"><img src="img/gitops_conceptual_diagram.svg" alt="Conceptual diagram of GitOps-based infrastructure" width="800px" /></p>
+
 ## Why is GitOps awesome? <!-- omit in toc -->
 
 It [increases developer productivity](https://www.weave.works/technologies/gitops/#key-benefits), [enhances developer experience](https://www.weave.works/technologies/gitops/#key-benefits), [improves stability](https://www.weave.works/technologies/gitops/#key-benefits), all while having [higher reliability](https://www.weave.works/technologies/gitops/#key-benefits), [higher consistency](https://www.weave.works/technologies/gitops/#key-benefits) and [stronger security guarantees](https://www.weave.works/technologies/gitops/#key-benefits).