diff --git a/README b/README
new file mode 100644
index 0000000..679fda2
--- /dev/null
+++ b/README
@@ -0,0 +1,37 @@
+This is a personal project to generate a 2D maze using in depth path generation.
+
+this can generate a stl file, overall goal was to print it with a 3D printer, i didn't test it yet ( even i hav actualy have a 3D printer ).
+
+This is the very first usable part.
+It was developped under debian 7/8 but since it is java based it might be very easily recompiled or even just copied on other platform.
+
+run it by :
+
+cd java
+make display
+( it will compile and run it ).
+it ask fro three integers :
+
+X Y maxpath
+
+ex :
+
+10 10 7
+
+will generate a 10x10 labyrinth with trying to fork a different path every 7 steps.
+
+then it saves labyrinth under java/lab directory under two format :
+- one reusable by this tool that contains all solutions. ( .lab )
+- one in stl that can be viewed with blender or sliced with slic3r to feed a 3D printer ( not yet tested ).
+
+buttons left,right,up,left can be used to walk the labyrinth. resolve will display solution.
+and there is a control for sizing cells.
+
+It was tested up to 1000x1000 labyrinth and can realy generate huge labyrinth.
+
+Entry of labyrinth is upper left corner, exit is lower right ( this is different in 3D since Y axis where reversed ).
+
+
+BUGS are numerous, and every bug was cleverly designed to drive you mad.
+DOCUMENTATION is self contained in code an in my brain.
+