Merge pull request #2507 from sasha0/feature/docs

Add docs for price currencies.

docs/source/ref/settings.rst

@@ -368,6 +368,8 @@ Default: ``GBP``
 This should be the symbol of the currency you wish Oscar to use by default.
 This will be used by the currency templatetag.
 
+.. _currency-format-setting:
+
 ``OSCAR_CURRENCY_FORMAT``
 -------------------------
 

docs/source/topics/prices_and_availability.rst

@@ -161,6 +161,22 @@ For most projects, subclassing and overriding the ``Structured`` base class
 should be sufficient.  However, Oscar also provides mixins to easily compose the
 appropriate strategy class for your domain.
 
+Currency
+--------
+
+Oscar allows you to define a currency code for each stock - a text field that
+defaults to ``settings.OSCAR_DEFAULT_CURRENCY``.
+
+By default, Oscar expects all products added to a single basket to have the
+same currency. It does not however do any logic to select the appropriate
+stock record to achieve this - you must implement this yourself in the
+:func:`~oscar.apps.partner.strategy.Structured.select_stockrecord` method.
+Oscar does not determine or store user currency and uses it only for
+formatting product price. More complex logic, like currency switch or
+conversion can be implemented additionally.
+
+More about currency formatting configuration - :ref:`currency-format-setting`.
+
 Loading a strategy
 ------------------