Added some readme files to improve documentation.

Author: rfelber

README.md

@@ -65,7 +65,9 @@ The typical way to ensure application security is to hire a security specialist
 
 With the _secureCodeBox_ we provide a toolchain for continuous scanning of applications to find the low-hanging fruit issues early in the development process and free the resources of the penetration tester to concentrate on the major security issues.
 
-The purpose of _secureCodeBox_ **is not** to replace the penetration testers or make them obsolete. We strongly recommend running extensive tests by experienced penetration testers on all your applications.
+![secureCodeBox Architecture](./docs/resources/macbook_kibana.jpg)
+
+The purpose of _secureCodeBox_ **is not** to replace the penetration testers or make them obsolete. We strongly recommend to run extensive tests by experienced penetration testers on all your applications.
 
 **Important note**: The _secureCodeBox_ is no simple one-button-click-solution! You must have a deep understanding of security and how to configure the scanners. Furthermore, an understanding of the scan results and how to interpret them is also necessary.
 

docs/developer-guide/Architecture.md

@@ -0,0 +1,13 @@
+# Glossary
+
+This overview provides a description for all acronyms and special terms which are used in this project. If you encounter any missing terms, please [let us know](https://github.com/corona-warn-app/cwa-documentation/issues/new?labels=documentation%2C+bug&template=01_doc_issue.md) or [create a pull request](https://github.com/secureCodeBox/secureCodeBox-v2/pulls).
+
+| Term, acronym... | Description |
+| --- | --- |
+| API | An [Application Programming Interface](https://en.wikipedia.org/wiki/Application_programming_interface) (API) is a computing interface which defines interactions between multiple software intermediaries. |
+| CRD | Acronym for "[Custom Ressource Definition](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/)". |
+| GUID | Acronym for "[Globally Unique Identifier](https://en.wikipedia.org/wiki/Universally_unique_identifier)". |
+| K8S | Acronym for "[Kubernetes](https://kubernetes.io/docs/home/)". |
+| SCB | Acronym for "[secureCodeBox (This Project)](https://www.secureCodeBox.io)". |
+
+

docs/developer-guide/CRDs.md

@@ -7,14 +7,16 @@
 ## Documentation Overview
 
 <!-- toc -->
-- [Project Readme and Quickstart][scb-github]
-- [User Guide](user-guide/README.md)
-- [Developer Guide](developer-guide/README.md)
+- [Project Readme and Quickstart][scb-github] Start here if you want to get a brief overview and installation quickstart
+- [User Guide](user-guide/README.md) If you want to configure security automation in your environment, please take a look into our user guide.
+- [Developer Guide](developer-guide/README.md) If you want to extend the project an add your own compents or bugfix something, please take a look into our developer guide.
+- [Glossary](glossary.md) This overview provides a description for all acronyms and special terms which are used in this project.
+- [Versioning](versioning.md) This describes how we use versioning in tags and releases.
 
 <!-- tocstop -->
 
 ## Need a human?
-- [Join Slack][scb-slack]
+- [Join us -> Slack][scb-slack] 💬
 
 ## License
 Code of secureCodeBox is licensed under the [Apache License 2.0][scb-license].