[#1211] Correct a typo
Merge pull request #1211 from okfn/1211-add-exception-guidelines

Add exception guidelines to Python coding standards
[#1210] Minor changes after review
[#1210] Add some docs
[#943] Autodoc the plugins toolkit

ckan.plugins.toolkit isn't compatible with autodoc. Autodoc supports
modules and classes, but the plugins toolkit is actually an
object-instance masquerading as a module.

Added a Sphinx extension to do what autodoc does for classes and
modules, but for the plugins toolkit object.

Added a custom __dir__() method to the plugins toolkit so that
inspect.getmembers() works as desired for it.
[#943] Add some docstrings to lib/base.py

These are functions that are imported into the plugins toolkit, so they
need docstrings.
[#943] Add a docstrings to lib/cli.py

This class is imported into the plugins toolkit, so it needs a docstring.
[#943] Add some docstrings to helpers.py.

Everything in the template helpers module should have a docstring.
[#943] Add a docstring to Invalid exception

This exception is imported into the plugins toolkit so it needs a
docstring.
[#943] Improve DefaultDatasetForm's docstring
[#943] Add some docstrings to logic/__init__.py

These functions and exceptions are imported into the plugins toolkit, so
they need docstrings.
[#943] Add some docstrings to plugins/toolkit.py.

Everything in the plugins toolkit should have a docstring.
Merge branch 'master' of github.com:okfn/ckan into 943-writing-extensions-tutorial
Add config template stanza for ckan.storage.bucket

This was lost in e0cd7ba46e260b503b4090d1a382c5bc5dcf7db8
Better config stanza and doc for ckan.storage
[#943] Add custom docstrings for some 3rd-party stuff

The plugins toolkit imports some things from 3rd-party libraries, e.g.
the request, response and c objects from Pylons. We want to use our own
docstrings for these rather than having the 3rd-party docstrings appear
in the CKAN docs. Also in some cases the 3rd-psrty function has no
docstring, or introspection would end up with a class docstring where
what we actually want is to document a specific object-instance.

So add custom docstring overrides as a feature implemented in toolkit.py
and toolkit_sphinx_extension.py.
[#1126] Brings featured groups/orgs from from be06121 into this branch

It's just a slightly edited version of
https://github.com/okfn/ckan/blob/be06121/ckanext/featured/plugin.py as now
the helpers are returning data and not data+html.
Merge branch 'master' into 1117-start-new-test-suite
[#943] Rearrange the writing extensions docs

But the different parts into different pages
[#943] Add cross-ref from authorization docs to IAuthFunctions