diff --git a/readme.txt b/readme.txt
index 20ff14f06..3a05a7c05 100644
--- a/readme.txt
+++ b/readme.txt
@@ -1,12 +1,4 @@
-
-! WARNING ! 
------------
-
-This software is not complete. This is just a preview. Don't expect to find any 
-interface consistencies between releases at all. With each release, everything 
-you once knew and loved may be brutally murdered. By which I mean removed and/or 
-changed.
-
+LÖVE is an *awesome* framework you can use to make 2D games in Lua. It's free, open-source, and works on Windows, Mac OS X and Linux.
 
 RUNNING GAMES
 -------------
@@ -22,4 +14,24 @@ Examples:
 * love mygame.love
 * love /home/hax/ultragame
 
-Remember that what you are trying to run at least should contain the file "main.lua".
\ No newline at end of file
+Remember that what you are trying to run at least should contain the file "main.lua". 
+
+Compilation
+-----------
+
+Windows:
+	Use the project files for Visual C++ 2008 or 2010 (2010 preferred) located in the platform dir.
+*nix:
+	Run platform/unix/automagic, then run ./configure and make.
+OSX:
+	Use the XCode project in platform/macosx.
+
+
+! WARNING ! 
+-----------
+
+This software is not complete. This is just a preview. Don't expect to find any 
+interface consistencies between releases at all. With each release, everything 
+you once knew and loved may be brutally murdered. By which I mean removed and/or 
+changed.
+