Currently, a product's stockrecords are used to decide if a user is
allowed to edit a product or not. That doesn't work for parent products,
because they don't have stockrecords. So it's not possible to decide
whether a user is allowed to edit a parent product (and e.g. create
children) for it.

As far as I'm aware, this is not a regression of the
permission-dashboard; I don't think it ever worked. It just hasn't been
spotted because nobody needed it.

This commit also adds some tests to ensure this is enforced.

The howto recipe on shipping has been rewritten to describe the new
changes to shipping functionality. The old shipping app reference has
been merged in too to avoid duplication.

Allow using a different app than promotions as the homepage view.

- Expand the ref/apps docs. (Still lots to do here.)
- Split up the index page links for clarity.

Done as it became apparent in #968 that further clarification is needed.

 - make sure all pages are linked from somewhere
 - prohibit double indexing of source code modules
 - remove old unused offers (we use GIT, no need to keep old files)
 - use local version of Oscar logo

Fixes #921

With details of new prices/availability structure.

Add documentation and hide visibility from UI

We currently mention it in internals/sandbox.rst. I've added a note to
the dashboard app (ref/apps/dashboard.rst), the sandbox/urls.py and
expanded on the feature explanation on index.rst.

Fixes #816

They were missing the autodoc documentation for views (abstract) and
abstract models.
Also added two docstrings to the views in the promotions app to have
them showing in the autodoc.

Some of them are rather basic, but it's a start.

- Added stubs for both apps
- Switched to using :automodule: for abstract models instead of
  individual :autoclass:
- Added instructions on creating a Partner and ProductClass instance
  when setting up a new Oscar instance

They were getting quite long. They've been split up in several
subsections. Some of them are borrowing heavily from the Django docs.

To set a base for upcoming docs changes, the docs directory structure
has been streamlined to follow a simplified version of Django's docs.

The old _draft folder has been removed. Both files from there and the
current docs that don't fit nicely into the new structure are in _old/
for the moment.