These have the same problem (with pasting code examples into the docs) as above. This stuff belongs in the docstrings of the `IConfigurable` plugin interface and of the methods in `ckan.plugins.toolkit`, and then they should be autodoc'd into this chapter.

I can see why you might want to single-out some very common and useful things like these, because just burying them in the middle of the reference docs among all the not-as-useful stuff just makes them hard to find and isn't very helpful. But I think for now, we should just allow them to be buried, and come up with a solution later once the dust has settled. Maybe we can highlight the most useful plugin interfaces and toolkit methods somehow, or pop them to the top of the list. I'm not sure.

What do you think?