Documentation guidelines tweaks

Various small changes that we discussed at the CKAN summit.
Tweak call_action docstring

Make it clear that it skips auth
Fix a couple of broken Sphinx includes
Merge pull request #1489 from ckan/docs-tweaks-from-ckan-summit-winter-2014

Docs tweaks from ckan summit winter 2014