--- a/oauth/README.md	Tue Feb 16 15:43:00 2016 +0100
+++ b/oauth/README.md	Tue Feb 16 15:46:00 2016 +0100
@@ -1,9 +1,24 @@
-# Example for OAuth 2 Server
-
-This is an example of OAuth 2 Server.
-
-Find more details on <http://lepture.com/en/2013/create-oauth-server>
+# Example OAuth 2 Server & GED mock client
 
 # INSTALLATION
 
+use a different virtualenv than the one for the django metaeducation app
+
+$ mkvirtualenv mtdc_oauth_env
 $ pip install -r requirements.txt
+
+# CONFIGURATION
+
+Edit client_settings.py.tmpl and oauth_settings.py.tmpl to match your renkan django app config.
+
+# RUNNING
+
+To run the oauth server:
+
+$ workon mtdc_oauth_env
+$ python oauth.py
+
+To run the GED mock client:
+
+$ workon mtdc_oauth_env
+$ python client.py
\ No newline at end of file