diff --git a/tests/__init__.py b/tests/__init__.py
new file mode 100644
index 0000000..d2882f3
--- /dev/null
+++ b/tests/__init__.py
@@ -0,0 +1,5 @@
+# -*- coding: utf-8 -*-
+import tests
+__test__ = {
+    "Doctest": tests,
+}
diff --git a/tests/tests.py b/tests/tests.py
new file mode 100644
index 0000000..c6d0fd1
--- /dev/null
+++ b/tests/tests.py
@@ -0,0 +1,131 @@
+"""
+Test suite for the Mailman UI.
+This document both acts as a test for all the functions implemented in the UI
+as well as documenting what has been done.
+
+# To start the test, import the django test client.
+>>> from django.test.client import Client
+
+# Then instantiate a test client.
+>>> c = Client()
+
+# Go to the start page listing all lists.
+>>> response = c.get('/mailman_django/',)
+
+# Make sure the load was a success by checking the status code.
+>>> response.status_code
+200
+
+# Try to create a new list. Accessing the page to create a new list redirects 
+# to a login page since we need admin authority to create a new list.
+>>> response = c.get('/mailman_django/lists/new/')
+
+# Check that login required was in the HTML content of what was loaded
+>>> print "Login Required" in response.content
+True
+
+# Hence, we log in as an admin on the login page we get as a response to our 
+# call.
+>>> response = c.post('/mailman_django/lists/new/',{"address": "kevin@example.com", "password": "kevin"})
+
+# Check the content to see that we came to the create page after logging in.
+>>> print "Create a new list" in response.content
+True
+
+# Now create a new list called 'new_list'.
+>>> response = c.post('/mailman_django/lists/new/',{"listname": "new_list@example.com", "list_owner": "kevin@example.com", "list_type": "closed_discussion", "languages": "English (USA)"})
+
+# We should now end up on a success page offering what to do next. Let's check
+# that this was the case.
+>>> print "What would you like to do next?" in response.content
+True
+
+# Three options appear on this page. The first one is to mass subscribe users, 
+# the second is to go to the settings page of the list just created and the 
+# third is to create another list. 
+# We're still logged in so go to the page where the settings can be changed 
+# (this page also requires admin authority).
+>>> response = c.get('/mailman_django/settings/new_list%40example.com/',)
+
+# Try to update the settings. Here we must provide all the settings on the page 
+# to be allowed to update it.
+>>> response = c.post('/mailman_django/settings/new_list%40example.com/', {'send_welcome_msg': True, 'advertised': True, u'list_name': u'new_list', 'unsubscribe_policy': 9, 'autorespond_owner': 9, 'default_member_moderation': True, 'scrub_nondigest': True, 'subscribe_auto_approval': 'Subscribe auto approval (BLOB format) lorem ipsum dolor sit', u'fqdn_listname': u'new_list@example.com', 'gateway_to_news': True, 'encode_ascii_prefixes': True, 'generic_nonmember_action': 9, 'autoresponse_grace_period': 'Auto response grace period lorem ipsum dolor sit', 'autoresponse_owner_text': 'Auto response owner text lorem ipsum dolor sit', 'digest_is_default': True, 'bounce_info_stale_after': 'Bounce info stale after lorem ipsum dolor sit', 'welcome_msg': 'Welcome message lorem ipsum dolor sit', 'topics_enabled': True, 'digest_size_threshold': 9, 'header_matches': 'Header matches (BLOB format) lorem ipsum dolor sit', u'real_name': u'New_list', u'host_name': u'example.com', 'reject_these_nonmembers': 'Reject these non members (BLOB format) lorem ipsum dolor sit', 'collapse_alternatives': True, 'linked_newsgroup': 'Linked newsgroup lorem ipsum dolor sit', 'send_reminders': True, 'hold_these_nonmembers': 'Hold these non members (BLOB format) lorem ipsum dolor sit', 'digest_header': 'Digest header lorem ipsum dolor sit', 'archive_private': True, 'bounce_matching_headers': 'Bounce matching headers lorem ipsum dolor sit', 'bounce_score_threshold': 9, 'nondigestable': True, u'http_etag': u'"008c561be0aeaf134fea95066e5a7509a79e4842"', 'bounce_notify_owner_on_removal': True, 'autoresponse_request_text': 'Auto response request text lorem ipsum dolor sit', 'personalize': 'Personalize lorem ipsum dolor sit', 'max_num_recipients': 9, 'post_id': 9, 'send_goodbye_msg': True, 'max_days_to_hold': 9, 'pipeline': 'Pipeline lorem ipsum dolor sit', 'start_chain': 'Start chain lorem ipsum dolor sit', 'preferred_language': 'Preferred language lorem ipsum dolor sit', 'autorespond_requests': 9, 'msg_header': 'Message header lorem ipsum dolor sit', 'max_message_size': 9, 'bounce_you_are_disabled_warnings': 9, 'private_roster': True, 'require_explicit_destination': True, 'gateway_to_mail': True, 'digest_send_periodic': True, 'digestable': True, 'member_moderation_notice': 'Member moderation notice lorem ipsum dolor sit', 'bounce_you_are_disabled_warnings_interval': 'Bounce you are disabled warnings lorem ipsum dolor sit', u'self_link': u'http://localhost:8001/3.0/lists/new_list@example.com', 'digest_footer': 'Digest footer lorem ipsum dolor sit', 'discard_these_nonmembers': 'Discard these non members (BLOB format) lorem ipsum dolor sit', 'respond_to_post_requests': True, 'mime_is_default_digest': True, 'subject_prefix': 'Subject prefix lorem ipsum dolor sit', 'convert_html_to_plaintext': True, 'autorespond_postings': 9, 'msg_footer': 'Message footer lorem ipsum dolor sit', 'info': 'Info lorem ipsum dolor sit', 'reply_goes_to_list': 'Reply goes to list lorem ipsum dolor sit', 'obscure_addresses': True, 'include_list_post_header': True, 'news_moderation': 'News moderation lorem ipsum dolor sit', 'topics': 'Topics (BLOB format) lorem ipsum dolor sit', 'bounce_notify_owner_on_disable': True, 'goodbye_msg': 'Goodbye message lorem ipsum dolor sit', 'topics_bodylines_limit': 9, 'id': 9, 'filter_content': True, 'emergency': True, 'member_moderation_action': True, 'archive': True, 'nonmember_rejection_notice': 'Non member rejection notice lorem ipsum dolor sit', 'list_id': 'Some list ID lorem ipsum dolor sit', 'first_strip_reply_to': True, 'nntp_host': 'Nntp host lorem ipsum dolor sit', 'news_prefix_subject_too': True, 'bounce_processing': True, 'description': 'Description lorem ipsum dolor sit', 'reply_to_address': 'some_reply_to_address@lorem.ipsum', 'moderator_password': 'Moderator password lorem ipsum dolor sit', 'digest_volume_frequency': 'Digest volume frequency lorem ipsum dolor sit', 'include_rfc2369_headers': True, 'forward_auto_discards': True, 'ban_list': 'Ban list (BLOB format) lorem ipsum dolor sit', 'new_member_options': 9, 'subscribe_policy': 9, 'bounce_unrecognized_goes_to_list_owner': True, 'autoresponse_postings_text': 'Auto response postings text lorem ipsum dolor sit'})
+
+# If the post was successful, a positive response should appear in the HTML
+# content.
+>>> print "The list has been updated." in response.content
+True
+
+# Now we want to mass subscribe a few users to the list. Therefore, go to the 
+# mass subscription page.
+>>> response = c.get('/mailman_django/settings/new_list%40example.com/mass_subscribe/',)
+
+# Check that everything went well by making sure the status code was correct.
+>>> response.status_code
+200
+
+# Try mass subscribing the users 'liza@example.com' and 'george@example.com'.
+# Each address should be provided on a separate line so add '\\n' between the 
+# names to indicate that this was done (we're on a Linux machine which is why 
+# the letter 'n' was used and the double '\\' instead of a single one is to 
+# escape the raw string parsing of Python).
+>>> response = c.post('/mailman_django/settings/new_list%40example.com/mass_subscribe/',{"emails": "liza@example.com\\ngeorge@example.com"})
+
+# If everything was successful, we shall get a positive response from the page.
+# We'll check that this was the case.
+>>> print "The mass subscription was successful." in response.content
+True
+
+# Done with the admin stuff. Now let's log out.
+>>> response = c.get('/mailman_django/lists/logout/',)
+
+# If the request was successful we should end up on the list info page.
+# Now make sure that we got redirected there.
+>>> print "All mailing lists" in response.content
+True
+
+# Apart from just viewing a list of all the available lists we can view the 
+# information about one particular list on a list info page. On this page we 
+# can also subscribe or unsubscribe an email address to the list.
+# Let's try to subscribe to the list in the "normal" way 
+# (i.e. not using mass subscription). First we go to the page.
+>>> response = c.get('/mailman_django/lists/new_list%40example.com/',)
+
+# Then we check that everything went well.
+>>> response.status_code
+200
+
+# And finally we try to subscribe a user named 'Meg'.
+>>> response = c.post('/mailman_django/lists/new_list%40example.com/',{"email": "meg@example.com", "real_name": "Meg", "name": "subscribe", "listname": "new_list@example.com"})
+
+# This page contains a redirect so we check the status code for this.
+>>> response.status_code
+302
+
+# Then we check that the redirect gives the correct status code.
+>>> response = c.get("http://testserver/mailman_django/lists/")
+>>> response.status_code
+200
+
+# We'll now try unsubscribing the address we just subscribed.
+>>> response = c.post('/mailman_django/lists/new_list%40example.com/',{"email": "meg@example.com", "real_name": "Meg", "name": "unsubscribe", "listname": "new_list@example.com"})
+
+# If everything went well, we'll get a positive response saying so.
+>>> print "You have now been unsubscribed from new_list@example.com." in response.content
+True
+
+# Finally, let's delete the list.
+# We start by checking that the list is really there (for reference).
+>>> response = c.get('/mailman_django/lists/')
+>>> print "new_list@example.com" in response.content
+True
+
+# Then we delete the list...
+>>> response = c.post('/mailman_django/delete_list/new_list%40example.com/',)
+
+# ...and check that it's been deleted.
+>>> print "new_list@example.com" in response.content
+False
+
+# So far this is what you can do in the UI. More tests can be added here later.
+"""