From ad77808c42a96630cd39aac7379300ccc1f8be51 Mon Sep 17 00:00:00 2001
From: Steffen Illium <steffen.illium@ifi.lmu.de>
Date: Tue, 6 Jun 2023 12:10:08 +0200
Subject: [PATCH 1/2] Add new file

---
 quickstart/ReadMe.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 quickstart/ReadMe.md

diff --git a/quickstart/ReadMe.md b/quickstart/ReadMe.md
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/quickstart/ReadMe.md
@@ -0,0 +1 @@
+

From f54511bcd576df18b13881227fc7069875d4c5e6 Mon Sep 17 00:00:00 2001
From: Steffen Illium <steffen.illium@ifi.lmu.de>
Date: Tue, 6 Jun 2023 12:30:45 +0200
Subject: [PATCH 2/2] markdown refreshed

---
 README.md | 83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 83 insertions(+)

diff --git a/README.md b/README.md
index 65ac50b..6b16c79 100644
--- a/README.md
+++ b/README.md
@@ -8,3 +8,86 @@ Tackling emergent dysfunctions (EDYs) in cooperation with Fraunhofer-IKS
 3. Activate the virtual environment `source venv/bin/activate`
 4. Install the required dependencies `pip install -r requirements.txt`
 ## 
+
+## First Steps
+
+### Quickstart
+Most of the env. objects (entites, rules and assets) can be loaded automatically. 
+Just define what your environment needs in a *yaml*-configfile like:
+
+<details><summary>Example ConfigFile</summary>    
+    General:
+    level_name: rooms
+    env_seed: 69
+    verbose: !!bool False
+    pomdp_r: 5
+    individual_rewards: !!bool True
+
+    Entities:
+        Defaults: {}
+        Doors:
+            closed_on_init: True
+            auto_close_interval: 10
+            indicate_area: False
+        Destinations: {}
+
+    Agents:
+        Wolfgang:
+            Actions:
+                - Move8
+                - Noop
+                - DoorUse
+                - ItemAction
+            Observations:
+                - All
+                - Placeholder
+                - Walls
+                - Items
+                - Placeholder
+                - Doors
+                - Doors
+        Armin:
+            Actions:
+                - Move4
+                - ItemAction
+                - DoorUse
+            Observations:
+                - Combined:
+                    - Agent['Wolfgang']
+                    - Walls
+                    - Doors
+                    - Items
+    Rules:
+        Defaults: {}
+        Collision:
+            done_at_collisions: !!bool True
+        ItemRespawn:
+            spawn_freq: 5
+        DoorAutoClose: {}
+
+    Assets:
+    - Defaults
+    - Items
+    - Doors
+   </details>
+
+Have a look in [\quickstart](./quickstart) for further configuration examples.
+
+### Make it your own
+
+#### Levels
+Varying levels are created by defining Walls, Floor or Doors in *.txt*-files (see [./environment/levels](./environment/levels) for examples).
+Define which *level* to use in your *configfile* as: 
+```yaml
+General:
+    level_name: rooms    
+```
+... or create your own , maybe witht he help of [asciiflow.com](https://asciiflow.com/#/).
+
+#### Entites
+TODO
+#### Rules
+TODO
+ - Results
+#### Assets
+TODO