Added a bit of README

.gitignore

@@ -1 +1,2 @@
 *.pyc
+*~

AUTHORS

@@ -1,3 +1,4 @@
-django-allauth was started by Raymond Penners in October 2010,
-inspired by and partly based on existing projects such as Pinax
-(account app), Django-Socialauth, django-socialregistration.
+django-allauth was started by Raymond Penners
+(<raymond.penners@intenct.nl> or @pennersr) in October 2010, inspired
+by and partly based on existing projects such as Pinax (account app),
+Django-Socialauth, django-socialregistration.

README.rst

@@ -1,2 +1,45 @@
-TBD
+==============
+Django AllAuth
+==============
 
+Integrated set of Django applications addressing authentication,
+registration, account management as well as 3rd party (social) account
+authentication.
+
+Configuration
+=============
+
+Django
+------
+
+settings.py:
+
+    TEMPLATE_CONTEXT_PROCESSORS = (
+        ...
+        "allauth.account.context_processors.account"
+    )
+
+    AUTHENTICATION_BACKENDS = ('django.contrib.auth.backends.ModelBackend',
+                               'allauth.socialaccount.auth.SocialAccountBackend')
+
+    INSTALLED_APPS = (
+        'allauth',
+        'allauth.account',
+        'allauth.socialaccount',
+        'allauth.twitter',
+        'allauth.openid',
+        'allauth.facebook',
+
+urls.py:
+
+    urlpatterns = patterns('',
+        ...
+        (r'^accounts/', include('allauth.urls')))
+
+
+Facebook & Twitter
+------------------
+
+The required keys and secrets for interacting with Facebook and
+Twitter are to be configured in the database via the Django admin
+using the TwitterApp and FacebookApp models.