diff --git a/README b/README.md
similarity index 56%
rename from README
rename to README.md
index bb6998f..9e4e44e 100644
--- a/README
+++ b/README.md
@@ -1,7 +1,7 @@
-			      CapiSuite 
-			      =========
+CapiSuite 
+=========
 
-http://www.capisuite.de/
+http://www.capisuite.org/
 
 CapiSuite is an ISDN telecommunication suite providing easy to use
 telecommunication functions which can be controlled from Python
@@ -9,7 +9,8 @@ scripts. Currently, mainly voice functions and fax sending/receiving
 are supported.
 
 It uses a CAPI-compatible driver for accessing the ISDN-hardware, so
-you'll need an Eicon or AVM card with the according driver.
+you'll need an Eicon or AVM card or any mISDN supported adapter with the 
+according driver.
 
 CapiSuite is distributed with scripts providing a multi-user answering
 machine with automatic fax recognition, remote inquiry and fax
@@ -22,19 +23,29 @@ your feedback to the bug tracker and/or the mailing lists. Thank you!
 For the documentation see the created HTML documents situated in
 docs/manual/index.html or in the installed version see
 $PREFIX/share/doc/capisuite/manual/index.html. There's also a german
-translation of the manual available at http://www.capisuite.de/.
+translation of the manual available at http://www.capisuite.org/.
 
 
-Building capisuite from Git
+Building capisuite from git
 ---------------------------
 
-git clone https://github.com/larsimmisch/capisuite.git
 
-cd capisuite
-make -f Makefile.git
-./configure ...options...
-make
-su -c 'make install'
+	git clone https://github.com/larsimmisch/capisuite.git
+	cd capisuite
+	./configure ...options...
+	make
+	sudo make install
 
 Please see Makefile.git for other targets which may be useful for
 core-developers.
+
+Side notes
+----------
+
+This git repository was created from the svn dumps that Gernot Hillier
+kindly provided on http://www.capisuite.org/ and contains his and his 
+collaborators work.
+
+All credit should go to the original team. I (larsimmisch) have only made 
+minor bugfixes, in particular small changes that make capisuite compatible 
+with mISDN (the socket branches from http://git.misdn.eu/).