Plugin loading documentation is confusing

The yaml fragment currently documenting plugin loading is a copy paste job from a draft of the format between developers who already understand the context well.

This now needs to be rewritten so that it is explained and users can understand it.