Updated changelog/readme/version ahead of 0.3 release

CHANGELOG.rst

 =========
 
 0.3 
-~~~
+---
 
-**Important** - A new setting ``OSCAR_MAIN_TEMPLATE_DIR`` has been introduced
+* i18n support added - Oscar now ships with .po files for seven languages.
+  Translation files are welcome.
+* Category management added to dashboard
+* Some improvements to how group/variant products are handled
+* Improved installation process using makefile
+
+Migrations
+~~~~~~~~~~
+
+There are 3 new migrations in the catalogue app.  If you have a local version,
+you will need to run::
+
+    ./manage.py schemamigration catalogue --auto
+
+to pick up the changes in Oscar's catalogue app.
+
+Breaking changes
+~~~~~~~~~~~~~~~~
+
+A new setting ``OSCAR_MAIN_TEMPLATE_DIR`` has been introduced
 as the template structure has been altered.  This requires your
 ``TEMPLATE_DIRS`` setting to be altered to include this folder, eg::
 
     # base.html
     {% extends 'templates/base.html' %}
 
-* Category management added to dashboard
-
-* Some improvements to how group/variant products are handled
 
 0.2.1 - 09 July 2012
-~~~~~~~~~~~~~~~~~~~~
+--------------------
 
 Mainly small bug-fixes to templates and javascript.  
 
 0.2 - 01 June 2012
-~~~~~~~~~~~~~~~~~~
+------------------
 
 Many components have been rewritten since 0.1 - Oscar is much more of a complete
 package now.  New features include:
 two.
 
 0.1
-~~~
+---
 
 * Initial release - used in production by two major applications at Tangent but
   still quite rough around the edges.  Many features were implemented directly

README.rst

 * `Official homepage`_ 
 * `Sandbox site`_ (an hourly build of the unstable master branch - it's
   experimental but feel free to explore and get a feel for the base Oscar
-  install) 
+  install.  Dashboard access coming soon!) 
 * `Documentation`_ on the excellent `readthedocs.org`_
 * `Google Group`_ - the mailing list is django-oscar@googlegroups.com
 * `Continuous integration homepage`_ on `travis-ci.org`_
 and maintained by `Tangent Labs`_, a London-based digital agency, with help from
 `Mirumee`.
 
+.. _`David Winterbottom`: http://codeinthehole.com
+.. _`@codeinthehole`: https://twitter.com/codeinthehole
+.. _`Tangent Labs`: http://www.tangentlabs.co.uk
+.. _`Mirumee`: http://mirumee.com/
+
+Extensions
+----------
+
+* django-oscar-datacash_ - Integration with the DataCash_ payment gateway
+* django-oscar-paypal_ - Integration with PayPal.  This currently supports both
+  `Express Checkout`_ and `PayFlow Pro`_.
+* django-oscar-gocardless_ - Integration with the GoCardless_ payment gateway
+* django-oscar-jirafe_ - Integration with the Jirafe_ analytics package
+
+.. _django-oscar-datacash: https://github.com/tangentlabs/django-oscar-datacash
+.. _DataCash: http://www.datacash.com/
+.. _django-oscar-paypal: https://github.com/tangentlabs/django-oscar-paypal
+.. _`Express Checkout`: https://www.paypal.com/uk/cgi-bin/webscr?cmd=_additional-payment-ref-impl1
+.. _`PayFlow Pro`: https://merchant.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=merchant/payment_gateway
+.. _django-oscar-gocardless: https://github.com/tangentlabs/django-oscar-gocardless
+.. _GoCardless: https://gocardless.com/
+.. _django-oscar-jirafe: https://github.com/tangentlabs/django-oscar-jirafe
+.. _Jirafe: https://jirafe.com/
+
 License
 -------
 
 Oscar is released under the permissive `New BSD license`_.
 
-.. _`David Winterbottom`: http://codeinthehole.com
-.. _`@codeinthehole`: https://twitter.com/codeinthehole
-.. _`Tangent Labs`: http://www.tangentlabs.co.uk
 .. _`New BSD license`: https://github.com/tangentlabs/django-oscar/blob/master/LICENSE
-.. _`Mirumee`: http://mirumee.com/
 
 Case studies
 ------------
 Oscar is still in active development, but is used in production by a range of
 companies, from large multinationals to small, boutique stores:
 
+Tangent projects:
+
 * Tata Group - http://www.landmarkonthenet.com
 * Carlsberg - Their global "We Deliver More" platform is powered by Oscar (but
   is a B2B site so it not browsable by the public).
-* Dolbeau - http://www.dolbeau.ca/
 * The UK Labour party - http://shop.labour.org.uk
 
+Non-Tangent:
+
+* Dolbeau - http://www.dolbeau.ca/
+
 Many more on the way.  If you use Oscar in production, please let us know.

oscar/__init__.py

 # Use 'final' as the 4th element to indicate
 # a full release
 
-VERSION = (0, 3, 0, 'alpha', 0)
-    
+VERSION = (0, 3, 0, 'final')
+
 def get_short_version():
     return '%s.%s' % (VERSION[0], VERSION[1])
 
     return version
 
 
-# Cheeky setting that allows each template to be accessible by two paths. 
+# Cheeky setting that allows each template to be accessible by two paths.
 # Eg: the template 'oscar/templates/oscar/base.html' can be accessed via both
-# 'base.html' and 'oscar/base.html'.  This allows Oscar's templates to be 
+# 'base.html' and 'oscar/base.html'.  This allows Oscar's templates to be
 # extended by templates with the same filename
 OSCAR_MAIN_TEMPLATE_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)),
                                        'templates/oscar')