diff --git a/CHALLENGES b/CHALLENGES
new file mode 100644
index 0000000..ed04546
--- /dev/null
+++ b/CHALLENGES
@@ -0,0 +1,8 @@
+this is a list of stuff that is still not understood in its workings and needs
+additional reverse engineering.
+
+projects like wake of gods and wcmi probably already have full knowledge on
+these matters, so help from them is warmly welcome
+
+ * how do map objects overlap? where is the information stored which objects
+   draw above or below others?
diff --git a/README b/README
new file mode 100644
index 0000000..1a9a32c
--- /dev/null
+++ b/README
@@ -0,0 +1,27 @@
+this is still not well tested, so mail me on any problems:
+
+j.schauer@email.de
+
+place your heroes of might and magic complete files in the same directory
+as hr.py and extractor.py
+ * H3bitmap.lod
+ * H3ab_bmp.lod
+ * H3sprite.lod
+ * H3ab_spr.lod
+ * Heroes3.snd
+ * H3ab_ahd.snd
+ * VIDEO.VID
+ * H3ab_ahd.vid
+
+open the commandline and navigate to this directory
+
+python extractor.py
+
+it will find itself the files above and extract them into a new data directory.
+the process will take half an hour due to heavy image manipulations which are
+very slow in python. The output will be around half a gigabyte.
+
+then place some scenario file in the maps folder and start heroes renaissance
+with a command like:
+
+python hr.py "A Viking We Shall Go"