diff --git a/README.md b/README.md
new file mode 100644
index 0000000..98823ab
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Description
+The enrolment plugin "enrol on approval" add an approval step into the course enrolment process.
+Users will be informed by mail as soon as their course application has been approved/rejected.
+
+* Moodle Forum: https://moodle.org/mod/forum/discuss.php?d=189334
+* Moodle Plugins Directory: https://moodle.org/plugins/view.php?plugin=enrol_apply
+
+# Installation
+## Install from moodle.org
+* go to https://moodle.org/plugins/view.php?plugin=enrol_apply and use the "Install now" Button
+
+## Install with git
+* use a command line interface of your choice on the destination system (server with moodle installation)
+* switch to the moodle enrol folder: cd /path/to/moodle/enrol/
+* git clone https://github.com/emeneo/apply.git
+* navigate on your moodle page to admin --> notifivations and follow the instructions
+
+## Install from zip
+* download zip file from github: https://github.com/emeneo/apply/archive/master.zip
+* unpack zip file to /path/to/moodle/enrol/
+* navigate on your moodle page to admin --> notifivations and follow the instructions
diff --git a/README.txt b/README.txt
deleted file mode 100644
index 725e7da..0000000
--- a/README.txt
+++ /dev/null
@@ -1,5 +0,0 @@
-How to install:
-
-1. extract file and put the /apply folder into the folder /enrol
-
-2. go to admin --> notifications and install the plugin
\ No newline at end of file