[#1022] Fix cross-references in API docstrings

Use :py:func:, :py:class: etc to do proper hyperlinked cross-references.

Also a few other minor docstrings formatting fixes.
[#1389] Tweak release process docs
[#1401] Delete the ckan_deb dir

It just contains a bunch of old scripts that don't work anymore
Merge branch 'master' of github.com:okfn/ckan into 1389-release-docs-tweaks-2
Merge pull request #1401 from okfn/1401-delete-ckan_deb-dir

[#1401] Delete ckan_deb dir
Merge branch 'master' of github.com:okfn/ckan into 1389-release-docs-tweaks-2
[#1389] Reorganize the release process docs a little

Put all the stuff that users need to know (what the different types of
release are, and how to upgrade) in /upgrading.html, and put all the
stuff for developers only (how to do a CKAN release) in /contributing/.
Use ..  seealso:: boxes to link the two pages together. Also removed
some duplicated information, fixed some title styles, etc.
[#1389] Fix a Sphinx error
Merge branch '1389-release-docs-tweaks-2'
Add a note about seealso boxes in the docs
Merge branch '1022-api-docs-improvements'