Added example how to integrate 'cash-on-delivery'

Added instructions to add custom product attributes to Solr index and OSCAR_SEARCH_FACETS

Also:
- change the default value of the "target_path" argument
- improve documentation of the "target_path" argument
- fix old documentation that says frontend and dashboard use different
  Bootstrap versions

`make css` has been renamed to `make assets`.

Co-authored-by: Basil Dubyk <samitnuk.work@gmail.com>
Co-authored-by: Alexander Gaevsky <sasha@sasha0.ru>
Co-authored-by: Joseph Wayodi <jwayodi@gmail.com>

get_available_shipping_methods must always return an iterable.

* Document how to customize dashboard forms. Thanks @okfish for providing instruction.

* Fix documentation for `OSCAR_INITIAL_LINE_STATUS`.
Setting value should be defained in the `OSCAR_LINE_STATUS_PIPELINE`, not `OSCAR_ORDER_STATUS_PIPELINE`.

- Remove outdated material relating to old versions of Django
- State that Oscar assumes that the email field is unique
- Update a number of links to Django documentation.
- Minor fixes to other bits of documentation.

* Add note about ``get_default_shipping_method`` shipping repository method to the documentation.
* Add note how to add custom node to the dashboard navigation with non-dashboard URLconf.

instead of South migrations

As per [their blog post of the 27th April](https://blog.readthedocs.com/securing-subdomains/) ‘Securing subdomains’:

> Starting today, Read the Docs will start hosting projects from subdomains on the domain readthedocs.io, instead of on readthedocs.org. This change addresses some security concerns around site cookies while hosting user generated data on the same domain as our dashboard.

Test Plan: Manually visited all the links I’ve modified.

Fix several issues with the CheckoutSessionMixin example given for
using a DeferredTax tax assessment approach:

- Test for submission['shipping_address'] and
  submission['shipping_method'].
- Update line item tax via line.purchase_info.price.tax.
- Refer to shipping_charge rather than shipping_method where
  appropriate.
- Base the shipping tax rate on the tax-exclusive, not tax-inclusive
  shipping charge.
- Fix indentation for the calculate_tax convenience function.

Fixes issue django-oscar/django-oscar#1966.

The demo site was not kept up to date with the recent changes in Oscar
due to time contraints. It should be moved to a separate demo repository
in the future.

This might be resurrected in a separate repository in the future.

django-compressor used to trigger processing of the less files during
development. But with the browser-based compiler, an easy replacement is
available. This even lowers the barrier to altering styles, because
getting npm up and running isn't required.

Offline compilation isn't impacted.

Using the most current less version seems to not cause any trouble, so I
removed the version requirement.

Transactions were improved with Django 1.6; the atomic decorator was
added at the same time. We could've removed this helper earlier, but
better late than never.

There's no extension for it at the moment, but it seems to confuse
users. See #995.

This reflects the change in the repo URL.

Have tested on sandobx site seems all working,
not sure if you need more testing on it.

Fixes #1541.

During many payment flows, the user is able to cancel the process.
This should often be treated differently from a payment error,
e.g. it might not be appropriate to offer to retry the payment.

This exception adds gives us a good way to address that case.

Closes #1528.