-Welcome to your wiki! This is the default page we've installed for your convenience. Go ahead and edit it.
-This wiki uses the [[http://www.wikicreole.org/|Creole]] syntax, and is fully compatible with the 1.0 specification.
-The wiki itself is actually a hg repository, which means you can clone it, edit it locally/offline, add images or any other file type, and push it back to us. It will be live immediately.
-$ hg clone http://bitbucket.org/ubernostrum/django-registration/wiki/
-Wiki pages are normal files, with the .wiki extension. You can edit them locally, as well as creating new ones.
-=== Syntax highlighting ===
-You can also highlight snippets of text, we use the excellent [[http://www.pygments.org/|Pygments]] library.
-Here's an example of some Python code:
- formatter = lambda t: "funky"+t
-You can check out the source of this page to see how that's done, and make sure to bookmark [[http://pygments.org/docs/lexers/|the vast library of Pygment lexers]], we accept the 'short name' or the 'mimetype' of anything in there.
+== django-registration ==
+This is a simple application which provides flexible user registration for [[http://www.djangoproject.com/|Django-based projects]]. The default setup implements a fairly common workflow:
+# User signs up for account.
+# User receives an email containing instructions for activating the account.
+# User activates and begins using the site.
+This application assumes that you are already have a working installation of Django 1.0 or newer, and that you are comfortable enough with Django to be able to, for example, create templates based on a description of what context variables are available to them, set up your own URL configuration and work with Django's forms system.
+There are three basic ways to install: automatically installing a package using Python's package-management tools, manually installing a package, and installing from a Mercurial checkout.
+==== Using a package-management tool ====
+The easiest way by far to install django-registration and most other interesting Python software is by using an automated package-management tool, so if you're not already familiar with the available tools for Python, now's as good a time as any to get started.
+The most popular option currently is [[http://peak.telecommunity.com/DevCenter/EasyInstall|easy_install]]; refer to its documentation to see how to get it set up. Once you've got it, you'll be able to simply type
+And it will handle the rest.
+Another option that's currently gaining steam (and which I personally prefer for Python package management) is [[http://pypi.python.org/pypi/pip/|pip]]. Once again, you'll want to refer to its documentation to get up and running, but once you have you'll be able to type
+pip install django-registration
+==== Manually installing the 0.7 package ====
+If you'd prefer to do things the old-fashioned way, you can manually download the django-registration 0.7 package from [[http://pypi.python.org/pypi/django-registration/0.7|the Python Package Index]]. This will get you a file named "django-registration-0.7.tar.gz" which you can unpack (double-click on the file on most operating systems) to create a directory named "django-registration-0.7". Inside will be a script named "setup.py"; running
+will install django-registration (though keep in mind that this defaults to a system-wide installation, and so may require administrative privileges on your computer).
+==== Installing from a Mercurial checkout ====
+If you have [[http://www.selenic.com/mercurial/wiki/|Mercurial]] installed on your computer, you can also obtain a complete copy of django-registration by typing
+hg clone http://bitbucket.org/ubernostrum/django-registration/
+Inside the resulting "django-registration" directory will be a directory named "registration", which is the actual Python module for this application; you can symlink it from somewhere on your Python path. If you prefer, you can use the setup.py script in the "django-registration" directory to perform a normal installation, but using a symlink offers easy upgrades: simply running "hg pull -u" inside the django-registration directory will fetch updates from the main repository and apply them to your local copy.
+=== After you've installed ===
+Have a look at the documentation (included in the "docs/" directory of the package, or [[http://www.bitbucket.org/ubernostrum/django-registration/src/tip/docs/|browsable online]] to see the next steps. [[http://www.bitbucket.org/ubernostrum/django-registration/src/tip/docs/overview.txt|The overview document]] will tell you what you need to know to get started, and from there you can read the rest of the documentation to see all of the available options and features.