diff --git a/README.md b/README.md
index 9b58b90..7fb21b1 100644
--- a/README.md
+++ b/README.md
@@ -24,3 +24,131 @@
alt="Built with Material for MkDocs"
/>
+
+## Sites
+
+| **Environment** | **URL** |
+|-----------------|-----------------------------------------|
+| Staging | https://stephan.preview.hadan.de |
+| Production | https://stephan.hadan.de |
+
+## Participate
+
+1. Make sure you are already have an account at https://git.hadan-it.com. If not pls be so kind to contact support@hadan-it.com.
+2. Contact support@hadan-it.com to be granted access to the stephan.hadan.de-repository.
+
+## Development
+
+Checkout this project:
+
+```
+git clone ssh://git@git.hadan-it.com:222/web/stephan.hadan.de.git
+```
+
+Install Python 3.12 with brew:
+
+```
+brew install python@3.12
+```
+
+Create a virtual environment at the project root - this is used to isolate project packages from the global packages.
+
+```
+$ python3.12 -m venv venv
+```
+
+Activate the environment.
+
+```
+$ source venv/bin/activate
+```
+
+Install mkdocs - this is covered in the project requirements file. Make sure you are at projects root.
+
+```
+$ make install
+```
+
+From time to time it is necessary to run the last command to update your mkdocs environment. Just run `make install` at regular intervals to stay up-to-date.
+
+### Upgrade to Python 3.12
+
+Delete your venv folder inside your already existing checked out repository:
+
+```
+rm -rf venv
+```
+
+After that, close your terminal session, create a new one, navigate to your repository again. Then: please continue with "Install Python 3.12 with brew" in the above paragraph and update your environment
+
+### Folder structure
+
+```
+.
+├── CHANGELOG
+├── LICENSE
+├── README.md
+├── docs
+├── macros
+│ └── __init__.py
+├── mkdocs.yml
+├── overrides
+├── renovate.json
+├── requirements.txt
+├── resources
+└── venv
+```
+
+### Install dependencies for optimization function
+
+#### macOS
+
+```
+$ brew install cairo freetype libffi libjpeg libpng zlib pngquant
+```
+
+#### Linux
+
+```
+$ apt-get install libcairo2-dev libfreetype6-dev libffi-dev libjpeg-dev libpng-dev libz-dev pngquant
+```
+
+### Install WeasyPrint dependencies
+
+#### macOS
+
+The easiest way to install WeasyPrint on macOS is to use Homebrew.
+
+When Homebrew is installed, install Python, Pango and libffi:
+
+```
+$ brew install python pango libffi rust jpeg
+```
+
+### Generate and preview full documentation locally
+
+In the root of the checked out repository just use the following command to serve the documentation:
+
+```
+$ mkdocs serve
+```
+
+This will spin up your instance on port 8000 reacting on any changes you make until you stop the service with Ctrl+C
+
+## Contribute code/documentation
+
+To ensure a reasonable joint development of the documentation, it is necessary to derive each change reasonably into a separately named branch. The following prefixes are available for this purpose:
+
+* feat/ for new features/documentation
+* hotfix/ for changes to existing documentation
+
+Examples:
+
+* feat/new-blog-post
+* hotfix/translation-of-blog-entry
+
+After the development of the branch has been completed and extensively tested locally, a corresponding merge request is created in the **develop** branch and approved by a colleague. This ensures a high quality of the documentation and the necessary review.
+
+Once the request has been approved, it can be merged into the develop branch. An automatic build pipeline builds the new devel status on https://stephan.preview.hadan.de for reasons of overview, the source branch should be deleted accordingly during the merge.
+
+A merge from Devel to Main and a deployment via a build pipeline to https://stephan.hadan.de takes place at regular intervals. This merge is only carried out after consultation.
diff --git a/docs/assets/images/customer.png b/docs/assets/images/customer.png
new file mode 100644
index 0000000..ed8593f
Binary files /dev/null and b/docs/assets/images/customer.png differ
diff --git a/docs/assets/images/internal.png b/docs/assets/images/internal.png
new file mode 100644
index 0000000..dbce97d
Binary files /dev/null and b/docs/assets/images/internal.png differ
diff --git a/docs/assets/images/private.png b/docs/assets/images/private.png
new file mode 100644
index 0000000..d5cc968
Binary files /dev/null and b/docs/assets/images/private.png differ
diff --git a/docs/index.md b/docs/index.md
index 48abcef..c643c29 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -196,7 +196,34 @@ Einfacher und solider Hard- und Softwarerollout muss in Unternehmen Bestandteil
----
+---
+
+# Weitere Projekte
+
+### Abseits der ausführlich beschriebenen Projekte in den Steckbriefen habe ich noch viele weitere spannende Themen bearbeitet. Einen Überblick dazu findest du weiter unten – übersichtlich in Kategorien geordnet.
+
+
+
+- [](/projects/customerprojects/)
+
+ ### [Kundenprojekte](/projects/customerprojects/)
+
+- [](/projects/internalprojects/)
+
+ ### [Interne IT Projekte](/projects/internalprojects/)
+
+- [](/projects/privateprojects/)
+
+ ### [Private Projekte](/projects/privateprojects/)
+
+
+
+
+
+Illustrations by [unDraw](https://undraw.co/).
+
+---
+
# Bleiben wir in Kontakt
diff --git a/docs/projects/overview/index.md b/docs/projects/overview/index.md
index 462aa17..bd879b8 100644
--- a/docs/projects/overview/index.md
+++ b/docs/projects/overview/index.md
@@ -4,4 +4,24 @@ comments: false
---
# Projekte
-TBD
\ No newline at end of file
+Abseits der ausführlich beschriebenen Projekte in den Steckbriefen habe ich noch viele weitere spannende Themen bearbeitet. Einen Überblick dazu findest du weiter unten – übersichtlich in Kategorien geordnet.
+
+
+
+- [](/projects/customerprojects/)
+
+ ### [Kundenprojekte](/projects/customerprojects/)
+
+- [](/projects/internalprojects/)
+
+ ### [Interne IT Projekte](/projects/internalprojects/)
+
+- [](/projects/privateprojects/)
+
+ ### [Private Projekte](/projects/privateprojects/)
+
+
+
+
+
+Illustrations by [unDraw](https://undraw.co/).
\ No newline at end of file